KeyEventArgs.SuppressKeyPress Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define um valor que indica se o evento de chave deve ser passado para o controle subjacente.

public:
 property bool SuppressKeyPress { bool get(); void set(bool value); };

public bool SuppressKeyPress { get; set; }

member this.SuppressKeyPress : bool with get, set

Public Property SuppressKeyPress As Boolean

Valor da propriedade

Boolean

true caso o evento chave não deva ser enviado ao controle; caso contrário, false.

Exemplos

O exemplo de código a seguir impede que pressionamentos de teclas numéricos alcancem o TextBox controle chamado textBox1.

private void textBox1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode >= Keys.D0 && e.KeyCode <= Keys.D9 && e.Modifiers != Keys.Shift)
    {
        e.SuppressKeyPress = true;
    }
}

Private Sub TextBox1_KeyDown(ByVal sender As System.Object, _
    ByVal e As System.Windows.Forms.KeyEventArgs) Handles TextBox1.KeyDown
    
    If e.KeyCode >= Keys.D0 And e.KeyCode <= Keys.D9 And _
    e.Modifiers <> Keys.Shift Then
        e.SuppressKeyPress = True
    End If
End Sub

Comentários

Você pode atribuir true a essa propriedade em um manipulador de eventos, como KeyDown para impedir a entrada do usuário.

Definir SuppressKeyPress como true também define Handled como true.

Confira também

• Handled