Compartilhar via

Como verificar se há pressionamentos de tecla modificadora (Windows Forms .NET)

  • Artigo

À medida que o usuário digita teclas 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 pode ser salvo.

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

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

Por exemplo, a chave SHIFT é representada pelos seguintes valores de chave:

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 Keys.Control valores e Keys.Alt , respectivamente.

Detectar tecla modificadora

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

O exemplo de código a seguir mostra como determinar se a tecla SHIFT é pressionada nos manipuladores de KeyPress 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

Confira também