MaskedTextBox.MaskInputRejected Gebeurtenis
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Treedt op wanneer het invoer- of toegewezen teken van de gebruiker niet overeenkomt met het bijbehorende opmaakelement van het invoermasker.
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 Gebeurtenistype
Voorbeelden
In het volgende codevoorbeeld ziet u het gebruik van dit lid. In het voorbeeld rapporteert een gebeurtenis-handler over het optreden van de MaskInputRejected gebeurtenis. Dit rapport helpt u te leren wanneer de gebeurtenis plaatsvindt en u kan helpen bij het opsporen van fouten. Als u wilt rapporteren over meerdere gebeurtenissen of gebeurtenissen die vaak optreden, kunt u overwegen het bericht te vervangen MessageBox.ShowConsole.WriteLine door of toe te voegen aan een multiline TextBox.
Als u de voorbeeldcode wilt uitvoeren, plakt u deze in een project dat een exemplaar van het type MaskedTextBox met de naam MaskedTextBox1bevat. Zorg er vervolgens voor dat de gebeurtenis-handler is gekoppeld aan de MaskInputRejected gebeurtenis.
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
Opmerkingen
MaskInputRejected is de standaard gebeurtenis voor de MaskedTextBox klasse.
De MaskInputRejected gebeurtenis treedt op wanneer een teken wordt geweigerd door het invoermasker. Het invoermasker, vertegenwoordigd door de Mask eigenschap, wordt geïnterpreteerd door de gemaskeerde tekstprovider die is gekoppeld aan het besturingselement via de MaskedTextProvider eigenschap. MaskInputRejected treedt op in de volgende situaties:
Een invoerteken komt niet overeen met het bijbehorende opmaakelement. De gebruiker voert bijvoorbeeld een alfabetisch teken in wanneer een cijfer vereist is. Dit is waarschijnlijk de meest voorkomende reden waarom deze gebeurtenis wordt gegenereerd.
De gebruiker probeert overbodige tekens in te voeren buiten het einde van het masker, omdat het masker al is gevuld of de huidige caretpositie is verplaatst naar het einde van de weergegeven invoermaskertekenreeks.
Met een plakbewerking wordt een teken ingevoegd dat niet overeenkomt met het bijbehorende opmaakelement of als de IsOverwriteMode eigenschap is
false, worden bestaande tekens verplaatst naar nieuwe posities waar ze niet overeenkomen met hun opmaakelementen.Een knipbewerking verschuift bestaande tekens naar links en een of meer tekens komen niet overeen met de nieuw gekoppelde opmaakelementen.
Er is een toewijzing gemaakt aan de Text eigenschap en de toegewezen tekenreeks heeft een of meer maskerschendingen veroorzaakt.
Als een tekenreeks is toegewezen aan het besturingselement dat ervoor zorgt MaskInputRejected dat er geen deel van de tekenreeks wordt weergegeven in MaskedTextBox.
De standaardafhandeling voor MaskInputRejected het afspelen van een pieptoongeluid als de BeepOnError eigenschap is ingesteld op true. Deze gebeurtenis wordt vaak verwerkt om aangepaste foutafhandeling te implementeren, bijvoorbeeld om naar het volgende besturingselement voor gebruikersinvoer te gaan als het masker vol is of om een aangepast foutdialoogvenster of knopinfo weer te geven als het invoerteken ongeldig is.
