Demonstra Passo a passo: Trabalhando com o controle MaskedTextBox
As tarefas ilustradas neste passo a passo incluem:
Inicializando o MaskedTextBox controle
Usando o MaskInputRejected o manipulador de eventos para alertar o usuário quando um caractere não são compatíveis com a máscara
Atribuir um tipo para o ValidatingType propriedade e usando o TypeValidationCompleted o manipulador de eventos para alertar o usuário quando o valor que estão tentando confirmar não é válido para o tipo
Criando o projeto e adicionando um controle
Para adicionar um controle MaskedTextBox para seu formulário.
Abra o formulário no qual você deseja colocar o MaskedTextBox de controle.
Arrastar um MaskedTextBox de controle da caixa de ferramentas ao seu formulário.
O controle com o botão direito e escolha Propriedades. No Propriedades janela, selecione o máscara propriedade e clique o ... () botão reticências ao lado do nome da propriedade.
No A máscara de entrada caixa de diálogo, selecione o Data abreviada de máscara e clique em OK.
No Propriedades janela conjunto de BeepOnError propriedade para true. Essa propriedade causará um bipe curto de cada vez que o usuário tenta um caractere que viola a definição da máscara de entrada de som.
Para obter um resumo dos caracteres que a propriedade Mask oferece suporte, consulte a seção comentários a Mask propriedade.
Alertar o usuário a erros de entrada
Adicionar uma dica de balão para entrada de máscara rejeitadas
Retornar para o caixa de ferramentas e adicionar um ToolTip ao seu formulário.
Criar um manipulador de eventos para o MaskInputRejected o evento que dispara a ToolTip quando ocorre um erro de entrada. A dica de balão permanece visível por cinco segundos ou até que o usuário clica nele.
public void Form1_Load(Object sender, EventArgs e) { ... // Other initialization code maskedTextBox1.Mask = "00/00/0000"; maskedTextBox1.MaskInputRejected += new MaskInputRejectedEventHandler(maskedTextBox1_MaskInputRejected) } void maskedTextBox1_MaskInputRejected(object sender, MaskInputRejectedEventArgs e) { toolTip1.ToolTipTitle = "Invalid Input"; toolTip1.Show("We're sorry, but only digits (0-9) are allowed in dates.", maskedTextBox1, maskedTextBox1.Location, 5000); }
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load Me.ToolTip1.IsBalloon = True Me.MaskedTextBox1.Mask = "00/00/0000" End Sub Private Sub MaskedTextBox1_MaskInputRejected(sender as Object, e as MaskInputRejectedEventArgs) Handles MaskedTextBox1.MaskInputRejected ToolTip1.ToolTipTitle = "Invalid Input" ToolTip1.Show("We're sorry, but only digits (0-9) are allowed in dates.", MaskedTextBox1, 5000) End Sub
Alertar o usuário para um tipo que não é válido
Adicionar uma dica de balão para tipos de dados inválidos
Em seu formulário Load o manipulador de eventos, atribuir um Type objeto que representa o DateTime Digite para o MaskedTextBox do controle ValidatingType propriedade:
private void Form1_Load(Object sender, EventArgs e) { // Other code maskedTextBox1.ValidatingType = typeof(System.DateTime); maskedTextBox1.TypeValidationCompleted += new TypeValidationEventHandler(maskedTextBox1_TypeValidationCompleted); }
Private Sub Form1_Load(sender as Object, e as EventArgs) // Other code MaskedTextBox1.ValidatingType = GetType(System.DateTime) End Sub
Adicione um manipulador de eventos para o evento TypeValidationCompleted:
public void maskedTextBox1_TypeValidationCompleted(object sender, TypeValidationEventArgs e) { if (!e.IsValidInput) { toolTip1.ToolTipTitle = "Invalid Date Value"; toolTip1.Show("We're sorry, but the value you entered is not a valid date. Please change the value.", maskedTextBox1, 5000); e.Cancel = true; } }
Public Sub MaskedTextBox1_TypeValidationCompleted(sender as Object, e as TypeValidationEventArgs) If Not e.IsValidInput Then ToolTip1.ToolTipTitle = "Invalid Date Value" ToolTip1.Show("We're sorry, but the value you entered is not a valid date. Please change the value.", maskedTextBox1, 5000) e.Cancel = True End If End Sub
Consulte também
Referência
Outros recursos
Controle MaskedTextBox (Windows Forms)
Histórico de alterações
Date |
History |
Motivo |
---|---|---|
Setembro de 2010 |
Adicionado um link para o Mask propriedade, que resume os caracteres que oferece suporte de propriedade de máscara. |
Comentários do cliente. |