Compartilhar via

Como verificar pressionamentos de teclas modificadoras

À medida que o usuário digita chaves em seu aplicativo, você pode monitorar as teclas modificadoras pressionadas, como SHIFT, ALT e CTRL. Quando uma tecla modificadora é pressionada em combinação com outras teclas ou até mesmo um clique do mouse, seu aplicativo pode responder adequadamente. Por exemplo, pressionar a tecla S pode fazer com que um "s" apareça na tela. Se as teclas CTRL+S forem pressionadas, em vez disso, o documento atual poderá ser salvo.

Se você manipular o KeyDown evento, a KeyEventArgs.Modifiers propriedade recebida pelo manipulador de eventos especifica quais teclas modificadoras serão pressionadas. Além disso, a KeyEventArgs.KeyData propriedade especifica o caractere que foi pressionado junto com as teclas modificadoras combinadas com um OR bit a bit.

Se você estiver tratando o KeyPress evento ou um evento de mouse, o manipulador de eventos não receberá essas informações. Use a ModifierKeys propriedade da Control classe para detectar um modificador de chave. Em ambos os casos, você deve executar um AND bit a bit do valor apropriado Keys e o valor que está testando. A Keys enumeração oferece variações de cada chave modificadora, portanto, é importante que você faça a verificação AND bit a bit com o valor correto.

Por exemplo, os seguintes valores de chave representam a chave SHIFT :

O valor correto para testar SHIFT como uma chave modificadora é Keys.Shift. Da mesma forma, para testar CTRL e ALT como modificadores, você deve usar os valores Keys.Control e Keys.Alt, respectivamente.

Detectar chave modificadora

Detecte se uma tecla modificadora é pressionada comparando a ModifierKeys propriedade e o valor de Keys enumeração com um operador AND bit a bit.

O exemplo de código a seguir mostra como determinar se a tecla SHIFT é pressionada dentro dos KeyPress manipuladores de eventos e KeyDown .

// Event only raised when non-modifier key is pressed
private void textBox1_KeyPress(object sender, KeyPressEventArgs e)
{
    if ((Control.ModifierKeys & Keys.Shift) == Keys.Shift)
        MessageBox.Show("KeyPress " + Keys.Shift);
}

// Event raised as soon as shift is pressed
private void textBox1_KeyDown(object sender, KeyEventArgs e)
{
    if ((Control.ModifierKeys & Keys.Shift) == Keys.Shift)
        MessageBox.Show("KeyDown " + Keys.Shift);
}

' Event only raised when non-modifier key is pressed
Private Sub TextBox1_KeyPress(sender As Object, e As KeyPressEventArgs)
    If ((Control.ModifierKeys And Keys.Shift) = Keys.Shift) Then
        MessageBox.Show("KeyPress " & [Enum].GetName(GetType(Keys), Keys.Shift))
    End If
End Sub

' Event raised as soon as shift is pressed
Private Sub TextBox1_KeyDown(sender As Object, e As KeyEventArgs)
    If ((Control.ModifierKeys And Keys.Shift) = Keys.Shift) Then
        MessageBox.Show("KeyPress " & [Enum].GetName(GetType(Keys), Keys.Shift))
    End If
End Sub

Consulte também