Partilhar via


MaskedTextBox.MaskInputRejected Evento

Definição

Ocorre quando a entrada do usuário ou o caractere atribuído não coincide com o elemento de formato correspondente da máscara de entrada.

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 

Tipo de evento

Exemplos

O exemplo de código a seguir demonstra o uso desse membro. No exemplo, um manipulador de eventos relata a ocorrência do MaskInputRejected evento. Este relatório ajuda você a saber quando o evento ocorre e pode ajudá-lo na depuração. Para relatar vários eventos ou eventos que ocorrem com frequência, considere substituir MessageBox.ShowConsole.WriteLine por ou acrescentar a mensagem a uma multilinha TextBox.

Para executar o código de exemplo, cole-o em um projeto que contém uma instância do tipo MaskedTextBox chamada MaskedTextBox1. Em seguida, verifique se o manipulador de eventos está associado ao MaskInputRejected evento.

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

Comentários

MaskInputRejected é o evento padrão para a MaskedTextBox classe .

O MaskInputRejected evento ocorre quando um caractere é rejeitado pela máscara de entrada. A máscara de entrada, representada pela Mask propriedade , é interpretada pelo provedor de texto mascarado associado ao controle por meio da MaskedTextProvider propriedade . MaskInputRejected é gerado nas seguintes situações:

  • Um caractere de entrada não corresponde ao elemento de formato correspondente. Por exemplo, o usuário insere um caractere alfabético quando um dígito é necessário. Esse é provavelmente o motivo mais comum pelo qual esse evento é gerado.

  • O usuário está tentando inserir caracteres estranhos além do final da máscara porque a máscara já foi preenchida ou a posição atual do cursor foi movida para o final da cadeia de caracteres de máscara de entrada exibida.

  • Uma operação de colagem insere um caractere que não corresponde ao elemento de formato associado ou, se a IsOverwriteMode propriedade for false, ela desloca os caracteres existentes para novas posições em que eles não correspondem aos elementos de formato.

  • Uma operação de corte desloca os caracteres existentes para a esquerda e um ou mais caracteres não correspondem aos elementos de formato recém-associados.

  • Uma atribuição foi feita à Text propriedade e a cadeia de caracteres atribuída causou uma ou mais violações de máscara.

Se uma cadeia de caracteres tiver sido atribuída ao controle que causa a ocorrência, nenhuma parte da cadeia de caracteres MaskInputRejected será exibida em MaskedTextBox.

O tratamento padrão para MaskInputRejected reproduzirá um som de bipe se a BeepOnError propriedade estiver definida truecomo . Esse evento geralmente é manipulado para implementar o tratamento de erros personalizados, por exemplo, para passar para o próximo controle de entrada do usuário se a máscara estiver cheia ou para exibir uma caixa de diálogo de erro personalizada ou Dica de Ferramenta se o caractere de entrada for inválido.

Aplica-se a

Confira também