MaskedTextBox.MaskInputRejected Händelse
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Inträffar när användarens indata eller tilldelade tecken inte matchar motsvarande formatelement i indatamasken.
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 Händelsetyp
Exempel
Följande kodexempel visar hur den här medlemmen används. I exemplet rapporterar en händelsehanterare om händelsens MaskInputRejected förekomst. Den här rapporten hjälper dig att lära dig när händelsen inträffar och kan hjälpa dig att felsöka. Om du vill rapportera om flera händelser eller händelser som inträffar ofta kan du överväga att MessageBox.Show ersätta med Console.WriteLine eller lägga till meddelandet i en flerradig TextBox.
Om du vill köra exempelkoden klistrar du in den i ett projekt som innehåller en instans av typen MaskedTextBox med namnet MaskedTextBox1. Kontrollera sedan att händelsehanteraren är associerad med MaskInputRejected händelsen.
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
Kommentarer
MaskInputRejected är standardhändelsen MaskedTextBox för klassen.
Händelsen MaskInputRejected inträffar när ett tecken avvisas av indatamasken. Indatamasken Mask , som representeras av egenskapen, tolkas av den maskerade textprovidern som är associerad med kontrollen via MaskedTextProvider egenskapen. MaskInputRejected upphöjs i följande situationer:
Ett indatatecken matchar inte motsvarande formatelement. Användaren anger till exempel ett alfabetiskt tecken när en siffra krävs. Detta är förmodligen den vanligaste orsaken till att den här händelsen utlöses.
Användaren försöker mata in överflödiga tecken utanför maskens slut, antingen på grund av att masken redan har fyllts i eller om den aktuella caretpositionen har flyttats till slutet av den visade indatamasksträngen.
En inklistringsåtgärd infogar antingen ett tecken som inte matchar dess associerade formatelement, eller om IsOverwriteMode egenskapen är
false, flyttas befintliga tecken till nya positioner där de inte matchar deras formatelement.En utklippsåtgärd flyttar befintliga tecken till vänster och ett eller flera tecken matchar inte deras nyligen associerade formatelement.
En tilldelning gjordes till Text egenskapen och den tilldelade strängen orsakade en eller flera masköverträdelser.
Om en sträng har tilldelats till kontrollen som orsakar MaskInputRejected inträffar visas ingen del av strängen i MaskedTextBox.
Standardhanteringen för MaskInputRejected spelar upp ett pipljud om egenskapen BeepOnError är inställd på true. Den här händelsen hanteras ofta för att implementera anpassad felhantering, till exempel för att flytta till nästa användarinmatningskontroll om masken är full, eller för att visa en anpassad feldialogruta eller knappbeskrivning om indatatecknet är ogiltigt.
