Propriedade TextBox.InputMask (Access)

Utilize a propriedade InputMask para facilitar a introdução de dados e controlar os valores que os utilizadores podem introduzir num controlo de caixa de texto. String de leitura/gravação.

Sintaxe

expressão. Máscara de Introdução

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

Comentários

As máscaras de introdução são úteis para operações de introdução de dados, como uma máscara de introdução para um campo Número de Telefone que lhe mostra exatamente como introduzir um novo número: (___) ___-____. Muitas vezes, é mais fácil utilizar o Assistente de Máscaras de Introdução para definir a propriedade por si.

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

Seção	Descrição
Primeiro	Especifica a máscara de entrada; por exemplo, !(999) 999-9999. Para obter uma lista de carateres que pode utilizar para definir a máscara de introdução, consulte a tabela seguinte.
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 caráter que o Access apresenta para o espaço onde deve escrever um caráter na máscara de introdução. Nessa seção, você pode usar qualquer caractere; para exibir uma cadeia de caracteres vazia, use um espaço entre aspas (" ").

No Visual Basic, utiliza uma expressão de cadeia para definir esta propriedade. Por exemplo, o seguinte especifica uma máscara de introdução para um controlo de caixa de texto utilizado para introduzir 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 sinal de subtração [?] não permitidos).
9	Dígito ou espaço (entrada não necessária; sinal de adição e subtração 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 caráter real utilizado depende das definições na caixa de diálogo Propriedades das Definições Regionais no windows Painel de Controle).
<	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 utilizar a tecla Retrocesso para eliminar um caráter, o caráter é 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 introdução quando importa dados, executa uma consulta de ação ou introduz carateres num controlo ao definir a propriedade Text do controlo no Visual Basic ou através da ação SetValue numa macro.

Quando tiver definido uma máscara de introdução e definido a propriedade Formato para o mesmo campo, a propriedade Formatar tem precedência quando os dados são apresentados. 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 seguinte mostra algumas máscaras de introdução úteis e o tipo de valores que pode introduzir nas mesmas.

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, MAIO 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.