MaskedTextBox.MaskInputRejected Evento
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Ocorre quando a entrada ou o carácter atribuído ao utilizador não corresponde ao 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 seguinte exemplo de código demonstra a utilização deste elemento. No exemplo, um gestor de eventos reporta a ocorrência do MaskInputRejected evento. Este relatório ajuda-o a saber quando o evento ocorre e pode ajudá-lo na depuração. Para reportar múltiplos eventos ou eventos que ocorrem frequentemente, considere substituir MessageBox.Show ou Console.WriteLine anexar a mensagem a uma multilinha TextBox.
Para executar o código de exemplo, cole-o num projeto que contenha uma instância do tipo MaskedTextBox chamada MaskedTextBox1. Depois, certifique-se de que o gestor 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
Observações
MaskInputRejected é o evento padrão da MaskedTextBox classe.
O MaskInputRejected evento ocorre quando uma personagem é rejeitada pela máscara de entrada. A máscara de entrada, representada pela Mask propriedade, é interpretada pelo fornecedor de texto mascarado associado ao controlo através da MaskedTextProvider propriedade. MaskInputRejected é elevado nas seguintes situações:
Um carácter de entrada não corresponde ao elemento de formato correspondente. Por exemplo, o utilizador insere um carácter alfabético quando é necessário um dígito. Esta é provavelmente a razão mais comum pela qual este evento é levantado.
O utilizador tenta introduzir caracteres extras para além do final da máscara, seja porque a máscara já foi preenchida, quer porque a posição atual do caret foi movida para o final da cadeia de entrada da máscara apresentada.
Uma operação de colar insere um carácter que não corresponde ao elemento de formato associado, ou, se a IsOverwriteMode propriedade for
false, desloca os caracteres existentes para novas posições onde não correspondem aos seus elementos de formato.Uma operação de corte desloca os caracteres existentes para a esquerda, e um ou mais caracteres não correspondem aos seus novos elementos de formato associados.
Foi feita uma atribuição à Text propriedade e a cadeia atribuída causou uma ou mais violações de máscara.
Se uma cadeia foi atribuída ao controlo que causa MaskInputRejected a ocorrência, nenhuma parte da cadeia aparecerá em MaskedTextBox.
O tratamento padrão para MaskInputRejected irá emitir um som de bip se a BeepOnError propriedade estiver definida para true. Este evento é frequentemente tratado para implementar uma gestão personalizada de erros, por exemplo, para passar para o próximo controlo de entrada do utilizador se a máscara estiver cheia, ou para mostrar uma caixa de diálogo de erro personalizada ou uma dica de ferramenta se o carácter de entrada for inválido.
