MaskedTextBox.MaskInputRejected Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.
