KeyEventArgs.SuppressKeyPress Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Property SuppressKeyPress As BooleanEigenschaftswert
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
