MaskedTextBox.MaskFull Propriedade

Definição

Obtém um valor que indica se todas as entradas necessárias e opcionais foram inseridas na máscara de entrada.

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

Valor da propriedade

true se todas as entradas obrigatórias e opcionais tiverem sido inseridas; caso contrário, false.

Atributos

Exemplos

O exemplo de código a seguir manipula o MaskInputRejected evento e usa um ToolTip para alertar o usuário se for feita uma tentativa de inserir dados depois que todas as posições na máscara tiverem sido usadas.

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);
}

Comentários

Você pode usar a MaskFull propriedade dentro do MaskInputRejected manipulador de eventos para determinar se a entrada do usuário foi rejeitada porque não há entradas restantes na máscara. Para determinar se apenas os elementos de entrada necessários foram inseridos, use a MaskCompleted propriedade .

Aplica-se a

Produto Versões
.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

Confira também