KeyEventArgs.SuppressKeyPress Propriedade

Definição

Recebe ou define um valor que indica se o evento-chave deve ser passado para o controlo 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 de Propriedade

true se o evento-chave não deve ser enviado para o controlo; caso contrário, false.

Exemplos

O seguinte exemplo de código impede que as teclas numéricas cheguem ao TextBox controlo denominado 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

Observações

Pode atribuir true esta propriedade num gestor de eventos, por exemplo KeyDown , para evitar a entrada do utilizador.

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

Aplica-se a

Ver também