MaskedTextBox.MaskInputRejected Événement

Définition

Se produit lorsque l'entrée de l'utilisateur ou le caractère assigné ne correspond pas à l'élément de format correspondant du masque de saisie.

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 

Type d'événement

Exemples

L’exemple de code suivant illustre l’utilisation de ce membre. Dans l’exemple, un gestionnaire d’événements signale l’occurrence de l’événement MaskInputRejected . Ce rapport vous aide à savoir quand l’événement se produit et peut vous aider dans le débogage. Pour signaler plusieurs événements ou événements qui se produisent fréquemment, envisagez de MessageBox.ShowConsole.WriteLine remplacer par ou d’ajouter le message à un message multiligne TextBox.

Pour exécuter l’exemple de code, collez-le dans un projet qui contient un instance de type MaskedTextBox nommé MaskedTextBox1. Vérifiez ensuite que le gestionnaire d’événements est associé à l’événement MaskInputRejected .

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

Remarques

MaskInputRejected est l’événement par défaut pour la MaskedTextBox classe .

L’événement MaskInputRejected se produit lorsqu’un caractère est rejeté par le masque d’entrée. Le masque d’entrée, représenté par la Mask propriété, est interprété par le fournisseur de texte masqué associé au contrôle via la MaskedTextProvider propriété . MaskInputRejected est déclenché dans les situations suivantes :

  • Un caractère d’entrée ne correspond pas à l’élément de format correspondant. Par exemple, l’utilisateur entre un caractère alphabétique lorsqu’un chiffre est requis. C’est probablement la raison la plus courante pour laquelle cet événement est déclenché.

  • L’utilisateur tente d’entrer des caractères superflus au-delà de la fin du masque, soit parce que le masque a déjà été rempli ou que la position de caret actuelle a été déplacée à la toute fin de la chaîne de masque d’entrée affichée.

  • Une opération de collage insère un caractère qui ne correspond pas à l’élément de format associé ou, si la IsOverwriteMode propriété est false, elle déplace les caractères existants dans de nouvelles positions où ils ne correspondent pas à leurs éléments de format.

  • Une opération de coupe déplace les caractères existants vers la gauche, et un ou plusieurs caractères ne correspondent pas aux éléments de format nouvellement associés.

  • Une affectation a été effectuée à la Text propriété et la chaîne affectée a provoqué une ou plusieurs violations de masque.

Si une chaîne a été affectée au contrôle qui provoque MaskInputRejected l’apparition, aucune partie de la chaîne n’apparaît dans MaskedTextBox.

La gestion par défaut pour MaskInputRejected lira un bip sonore si la propriété a la trueBeepOnError valeur . Cet événement est souvent géré pour implémenter une gestion des erreurs personnalisée, par exemple, pour passer au contrôle d’entrée utilisateur suivant si le masque est plein, ou pour afficher une boîte de dialogue d’erreur personnalisée ou une info-bulle si le caractère d’entrée n’est pas valide.

S’applique à

Voir aussi