KeyEventArgs.SuppressKeyPress Propriété

Définition

Obtient ou définit une valeur indiquant si l'événement de touche doit être transmis au contrôle sous-jacent.Gets or sets a value indicating whether the key event should be passed on to the underlying control.

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

Valeur de propriété

true si l'événement de touche ne doit pas être transmis au contrôle ; sinon, false.true if the key event should not be sent to the control; otherwise, false.

Exemples

L’exemple de code suivant empêche les séquences de touches numériques d’atteindre le contrôle TextBox nommé textBox1.The following code example prevents numeric keystrokes from reaching the TextBox control named 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

Remarques

Vous pouvez assigner des true à cette propriété dans un gestionnaire d’événements tel que KeyDown afin d’éviter les entrées utilisateur.You can assign true to this property in an event handler such as KeyDown in order to prevent user input.

La définition de SuppressKeyPress sur true définit également Handled sur true.Setting SuppressKeyPress to true also sets Handled to true.

S’applique à

Voir aussi