Freigeben über


MaskedTextBox.MaskInputRejected Ereignis

Definition

Tritt ein, wenn die Eingabe oder das zugewiesene Zeichen nicht mit dem entsprechenden Formatelement der Eingabemaske übereinstimmt.

public:
 event System::Windows::Forms::MaskInputRejectedEventHandler ^ MaskInputRejected;
public event System.Windows.Forms.MaskInputRejectedEventHandler MaskInputRejected;
public event System.Windows.Forms.MaskInputRejectedEventHandler? MaskInputRejected;
member this.MaskInputRejected : System.Windows.Forms.MaskInputRejectedEventHandler 
Public Custom Event MaskInputRejected As MaskInputRejectedEventHandler 

Ereignistyp

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Members veranschaulicht. Im Beispiel meldet ein Ereignishandler das Auftreten des Ereignisses MaskInputRejected . Dieser Bericht hilft Ihnen, zu erfahren, wann das Ereignis eintritt, und kann Sie beim Debuggen unterstützen. Um über mehrere Ereignisse oder ereignisse zu berichten, die häufig auftreten, sollten Sie die Nachricht durch Console.WriteLine ein mehrlineiges TextBoxersetzen MessageBox.Show oder anfügen.

Um den Beispielcode auszuführen, fügen Sie ihn in ein Projekt ein, das eine instance des Typs MaskedTextBox enthältMaskedTextBox1. Stellen Sie dann sicher, dass der Ereignishandler dem MaskInputRejected Ereignis zugeordnet ist.

private void MaskedTextBox1_MaskInputRejected(Object sender, MaskInputRejectedEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Position", e.Position );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "RejectionHint", e.RejectionHint );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "MaskInputRejected Event" );
}
Private Sub MaskedTextBox1_MaskInputRejected(sender as Object, e as MaskInputRejectedEventArgs) _ 
     Handles MaskedTextBox1.MaskInputRejected

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "Position", e.Position)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "RejectionHint", e.RejectionHint)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"MaskInputRejected Event")

End Sub

Hinweise

MaskInputRejected ist das Standardereignis für die MaskedTextBox -Klasse.

Das MaskInputRejected Ereignis tritt auf, wenn ein Zeichen von der Eingabemaske abgelehnt wird. Die Durch die Mask -Eigenschaft dargestellte Eingabemaske wird vom maskierten Textanbieter interpretiert, der dem Steuerelement über die MaskedTextProvider -Eigenschaft zugeordnet ist. MaskInputRejected wird in den folgenden Situationen angesprochen:

  • Ein Eingabezeichen stimmt nicht mit dem entsprechenden Formatelement überein. Beispielsweise gibt der Benutzer ein alphabetisches Zeichen ein, wenn eine Ziffer erforderlich ist. Dies ist wahrscheinlich der häufigste Grund, warum dieses Ereignis ausgelöst wird.

  • Der Benutzer versucht, zusätzliche Zeichen über das Ende der Maske hinaus einzugeben, entweder weil die Maske bereits gefüllt wurde oder die aktuelle Caret-Position an das Ende der angezeigten Eingabemaskenzeichenfolge verschoben wurde.

  • Ein Einfügevorgang fügt entweder ein Zeichen ein, das nicht mit dem zugeordneten Formatelement übereinstimmt, oder wenn die IsOverwriteMode Eigenschaft ist false, verschiebt er vorhandene Zeichen an neue Positionen, an denen sie nicht mit ihren Formatelementen übereinstimmen.

  • Bei einem Ausschneiden werden vorhandene Zeichen nach links verschoben, und mindestens ein Zeichen entspricht nicht den neu zugeordneten Formatelementen.

  • Die -Eigenschaft wurde Text zugewiesen, und die zugewiesene Zeichenfolge verursachte mindestens eine Maskenverletzung.

Wenn dem Steuerelement eine Zeichenfolge zugewiesen wurde, die MaskInputRejected auftreten lässt, wird kein Teil der Zeichenfolge in MaskedTextBoxangezeigt.

Die Standardbehandlung für MaskInputRejected gibt einen Signalton ab, wenn die BeepOnError -Eigenschaft auf truefestgelegt ist. Dieses Ereignis wird häufig behandelt, um benutzerdefinierte Fehlerbehandlung zu implementieren, z. B. um zum nächsten Benutzereingabesteuerelement zu wechseln, wenn die Maske voll ist, oder um ein benutzerdefiniertes Fehlerdialogfeld oder eine QuickInfo anzuzeigen, wenn das Eingabezeichen ungültig ist.

Gilt für:

Weitere Informationen