KeyEventArgs.SuppressKeyPress Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft einen Wert ab, der angibt, ob das Key-Ereignis an das zugrunde liegende Steuerelement übergeben werden soll.

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

Eigenschaftswert

Boolean

true, wenn das Key-Ereignis nicht an das Steuerelement gesendet werden soll, andernfalls false.

Beispiele

Im folgenden Codebeispiel wird verhindert, dass numerische Tastatureingaben das Steuerelement mit dem TextBox Namen textBox1erreichen.

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

Hinweise

Sie können dieser Eigenschaft in einem Ereignishandler zuweisen true , z KeyDown . B. um Benutzereingaben zu verhindern.

Die Einstellung SuppressKeyPress auf legt auch auf fest Handledtrue.true

Weitere Informationen

• Handled