Propriedade TextBox.InputMask (Access)

  • Artigo

Use a propriedade InputMask para facilitar a entrada de dados e controlar os valores que os usuários podem inserir em um controle de caixa de texto. String de leitura/gravação.

Sintaxe

expressão. Máscaradeentrada

Expressão Uma variável que representa um objeto TextBox .

Comentários

Máscaras de entrada são úteis para operações de entrada de dados, como uma máscara de entrada para um campo Número de Telefone que mostra exatamente como inserir um novo número: (___) ___-____. Geralmente, é mais fácil usar o Assistente de Máscara de Entrada para definir a propriedade para você.

A propriedade InputMask pode conter até três seções separadas por ponto-e-vírgula (;).

Section Descrição
Primeiro Especifica a máscara de entrada; por exemplo, !(999) 999-9999. Para obter uma lista de caracteres que você pode usar para definir a máscara de entrada, consulte a tabela a seguir.
Segundo Especifica se o Microsoft Access armazena os caracteres literais de exibição na tabela quando você insere dados. Se você usar 0 para essa seção, todos os caracteres de exibição literais (por exemplo, os parênteses em uma máscara de entrada de número de telefone) são armazenados com o valor; se você inserir 1 ou deixar essa seção vazia, somente os caracteres digitados no controle serão armazenados.
Terceira Especifica o caractere que o Access exibe para o espaço em que você deve digitar um caractere na máscara de entrada. Nessa seção, você pode usar qualquer caractere; para exibir uma cadeia de caracteres vazia, use um espaço entre aspas (" ").

No Visual Basic, você usa uma expressão de cadeia de caracteres para definir essa propriedade. Por exemplo, o a seguir especifica uma máscara de entrada para um controle de caixa de texto usado para inserir um número de telefone.

Forms!Customers!Telephone.InputMask = "(###) ###-####"

Quando você cria uma máscara de entrada, pode usar caracteres especiais para exigir que determinados dados sejam inseridos (por exemplo, o código de área em um número de telefone) e que outros dados sejam opcionais (como um ramal de telefone). Esses caracteres especificam o tipo de dados, como um número ou um caractere, que você precisa inserir para cada caractere de máscara de entrada.

Você pode definir uma máscara de entrada usando os caracteres a seguir.

Caractere Descrição
0 Dígito (0 a 9, entrada necessária; mais [+] e menos [?] sinais não permitidos).
9 Dígito ou espaço (entrada não necessária; sinais de mais e menos não permitidos).
# Dígito ou espaço (entrada não obrigatória; os espaços são exibidos como espaços em branco no modo de edição, mas os espaços em branco serão removidos quando os dados forem salvos; os sinais de mais e de menos são permitidos).
L Letra (A a Z, entrada obrigatória).
? Letra (A a Z, entrada opcional).
A Letra ou dígito (entrada obrigatória).
a Letra ou dígito (entrada opcional).
& Qualquer caractere ou um espaço (entrada obrigatória).
C Qualquer caractere ou um espaço (entrada opcional).
. , : ; - / Marcador decimal e separadores de milhares, de data e de hora. (O caractere real usado depende das configurações na caixa de diálogo Propriedades de Configurações Regionais na Painel de Controle do Windows).
< Faz com que todos os caracteres sejam convertidos em minúsculas.
> Faz com que todos os caracteres sejam convertidos em maiúsculas.
! Faz com que a máscara de entrada seja exibida da direita para a esquerda, em vez de da esquerda para a direita. Os caracteres digitados na máscara sempre a preenchem da esquerda para a direita. Você pode incluir o ponto de exclamação em qualquer lugar da máscara de entrada.
\ Faz com que o caractere seguinte seja exibido como o caractere literal (por exemplo, \A é exibido como A).

Observação

A configuração da propriedade InputMask com a palavra "Password" cria um controle de entrada de senha. Qualquer caractere digitado no controle é armazenado como um caractere, mas é exibido como um asterisco (*). Você pode usar a máscara de entrada de senha para impedir a exibição dos caracteres digitados na tela.

Quando você digita dados em um campo para o qual foi definida uma máscara de entrada, os dados sempre serão inseridos no modo Sobrescrever. Se você usar a chave backspace para excluir um caractere, o caractere será substituído por um espaço em branco.

Se você mover o texto de um campo para o qual foi definida uma máscara de entrada para a Área de Transferência, os caracteres literais de exibição serão copiados, mesmo se você tiver especificado que eles não sejam salvos com os dados.

Observação

Apenas os caracteres que você digita diretamente em uma caixa de combinação ou de controle são afetados pela máscara de entrada. O Access ignora quaisquer máscaras de entrada ao importar dados, executar uma consulta de ação ou inserir caracteres em um controle definindo a propriedade Text do controle no Visual Basic ou usando a ação SetValue em uma macro.

Quando você define uma máscara de entrada e define a propriedade Format para o mesmo campo, a propriedade Format tem precedência quando os dados são exibidos. Isso significa que, mesmo que você tenha salvado uma máscara de entrada, a máscara de entrada será ignorada quando os dados forem formatados e exibidos. Os dados da tabela subjacente em si não serão alterados; a propriedade Format afeta apenas a exibição dos dados.

A tabela a seguir mostra algumas máscaras de entrada úteis e o tipo de valores que você pode inserir nelas.

Máscara de entrada Valores de exemplo
(000) 000-0000 (206) 555-0248
(999) 999-9999 (206) 555-0248, ( ) 555-0248
(000) AAA-AAAA (206) 555-TELE
#999 ?20, 2000
>L???? L?000L0 GREENGR339M3, MAY R 452B7
>L0L 0L0 T2F 8M4
00000-9999 98115-, 98115-3007
>L<?????????????? Maria, Brendan
SSN 000-00-0000 SSN 555-55-5555
>LL00000-0000 DB51392-0493

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.