MaskedTextBox.MaskFull Propriété

Définition

Obtient une valeur indiquant si toutes les entrées requises et facultatives ont été entrées dans le masque de saisie.

[System.ComponentModel.Browsable(false)]
public bool MaskFull { get; }

Valeur de propriété

true si toutes les entrées obligatoires et facultatives ont été entrées ; sinon, false.

Attributs

Exemples

L’exemple de code suivant gère l’événement MaskInputRejected et utilise un ToolTip pour avertir l’utilisateur si une tentative d’entrée de données est effectuée une fois que toutes les positions du masque ont été utilisées.

private void Form1_Load(object sender, EventArgs e)
{
    maskedTextBox1.Mask = "00/00/0000";

    maskedTextBox1.MaskInputRejected += new MaskInputRejectedEventHandler(maskedTextBox1_MaskInputRejected);
    maskedTextBox1.KeyDown += new KeyEventHandler(maskedTextBox1_KeyDown);
}

void maskedTextBox1_MaskInputRejected(object sender, MaskInputRejectedEventArgs e)
{
    if (maskedTextBox1.MaskFull)
    {
        toolTip1.ToolTipTitle = "Input Rejected - Too Much Data";
        toolTip1.Show("You cannot enter any more data into the date field. Delete some characters in order to insert more data.", maskedTextBox1, 0, -20, 5000);
    }
    else if (e.Position == maskedTextBox1.Mask.Length)
    {
        toolTip1.ToolTipTitle = "Input Rejected - End of Field";
        toolTip1.Show("You cannot add extra characters to the end of this date field.", maskedTextBox1, 0, -20, 5000);
    }
    else
    {
        toolTip1.ToolTipTitle = "Input Rejected";
        toolTip1.Show("You can only add numeric characters (0-9) into this date field.", maskedTextBox1, 0, -20, 5000);
    }
}

void maskedTextBox1_KeyDown(object sender, KeyEventArgs e)
{
    // The balloon tip is visible for five seconds; if the user types any data before it disappears, collapse it ourselves.
    toolTip1.Hide(maskedTextBox1);
}

Remarques

Vous pouvez utiliser la MaskFull propriété dans le MaskInputRejected gestionnaire d’événements pour déterminer si l’entrée de l’utilisateur a été rejetée, car il n’y a pas d’entrées restantes dans le masque. Pour déterminer si seuls les éléments d’entrée requis ont été entrés, utilisez la MaskCompleted propriété .

S’applique à

Produit Versions
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Voir aussi