Aplicação Windows - MaskedTextBox

Nesta aula iremos aprender como colocar mascara em nossos inputs de dados, obrigando o nosso usuário digitar de acordo com a mascara que colocarmos em nosso text.

Assine nossa Comunidade

Aplicação Windows -MaskedTextBox

MaskedTextBox é um componente caixa de texto que permite ao usuário digitar informação com formatação ou máscara.

Um exemplo de utilização de MaskedTextBox é quando queremos que o usuário digite o telefone, com o DDD e o número.

Podemos então inserir o componente MaskedTextBox com uma máscara para o DDD, que são os parêntesis, e para o número do telefone ,que é o traço(-). Exemplo: (11) 99888-7766

Dessa forma será gravado no banco de dados formatado e mostrará na tela também formatado.

O MaskedTextBox tem algumas especificações que devemos seguir, uma delas é a propriedade Mask

Nesta propriedade nós colocamos a máscara para que o usuário digite somente o que desejarmos.

Podemos configurar o MaskedTextBox com os tipos de máscaras abaixo:

0 - Digitar somente números obrigatórios;

9 - somente números não obrigatórios;

# - Números e + traço(-);

L - Somente letras[a-z A-Z];

& - Caracter obrigatório;

C - Caracter opcional;

$ - Moeda;

> - Maiúscula;

< - Minúscula;

Como inserir o componente MakedTextBox no formulário

Localizar o componente MakedTextBox na ToolBox ;
Arrastar e soltar o componente para o formulário;

Propriedade Mask

Para configurar a máscara do componente MaskedTextBox:

Clicar com o botão direito no componente e selecionar a propriedade Mask.
Na propriedade Mask digitamos +00(00)00000-0000 para máscara de telefone somente números.

Propriedade BeepOnError

A propriedade BeepOnError serve para tocar um som de alerta quando o usuário tentar digitar um caracter inválido.

Se quisermos ou não que esse som seja reproduzido na aplicação, configuramos a propriedade BeepOnError como true ou false, respectivamente.

Evento Leave

No evento leave do componente MaskedTextBox , é permitido fazer um código que será executado quando o usuário sair deste objeto.

Vamos fazer uma validação para verificar se o MaskedTextBox foi preenchido ou não. Para isso, vamos nomear o maskedTextBox para maskedTextBox1 e utilizar o método MaskCompleted.

      
        //utilizando o metodo maskCompleted para validar o componente.

        namespace WindowsFormsApplication  
        {
         public partial class FrmCadastro : Form 
         {
           public FrmCadastro()
           {
             InitializeComponent();
           }
           private void maskedTextBox1_Leave(object sender, EventArgs e)
           {
              if (maskedTextBox1.MaskCompleted)
              {
                MessageBox.Show ("Máscara completa");
              }
              else 
              {
                MessageBox.Show ("Máscara Incompleta");
              }

           }

         }
        }