Propriedade TextBox. MáscaraDeEntrada (Access)TextBox.InputMask property (Access)

Você pode usar a propriedade MáscaraDeEntrada para tornar a entrada de dados mais fácil e controlar os valores que os usuários podem inserir em um controle de caixa de texto.You can use the InputMask property to make data entry easier and to control the values that users can enter in a text box control. String de leitura/gravação.Read/write String.

SintaxeSyntax

expressão. MáscaraDeEntradaexpression.InputMask

expressão Uma variável que representa um objeto TextBox .expression A variable that represents a TextBox object.

ComentáriosRemarks

Máscaras de entrada são úteis para operações de entrada de dados, como uma máscara de entrada para um campo de número de telefone que mostra exatamente como inserir um (___) ___-____novo número:.Input masks are helpful for data-entry operations such as an input mask for a Phone Number field that shows you exactly how to enter a new number: (___) ___-____. Costuma ser mais fácil usar o Assistente de Máscara de Entrada para definir a propriedade para você.It is often easier to use the Input Mask Wizard to set the property for you.

A propriedade InputMask pode conter até três seções separadas por ponto-e-vírgula (;).The InputMask property can contain up to three sections separated by semicolons (;).

SeçãoSection DescriçãoDescription
PrimeiraFirst Especifica a máscara de entrada; por exemplo, !(999) 999-9999.Specifies the input mask itself; for example, !(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.For a list of characters that you can use to define the input mask, see the following table.
SegundaSecond Especifica se o Microsoft Access armazena os caracteres literais de exibição na tabela quando você insere dados.Specifies whether Microsoft Access stores the literal display characters in the table when you enter data. 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.If you use 0 for this section, all literal display characters (for example, the parentheses in a phone number input mask) are stored with the value; if you enter 1 or leave this section blank, only characters typed into the control are stored.
TerceiraThird Especifica o caractere que o Access exibe para o espaço em que você deve digitar um caractere na máscara de entrada.Specifies the character that Access displays for the space where you should type a character in the input mask. Nessa seção, você pode usar qualquer caractere; para exibir uma cadeia de caracteres vazia, use um espaço entre aspas (" ").For this section, you can use any character; to display an empty string, use a space enclosed in quotation marks (" ").

No Visual Basic, você usa uma expressão de cadeia de caracteres para definir essa propriedade.In Visual Basic, you use a string expression to set this property. Por exemplo, o seguinte especifica uma máscara de entrada para um controle de caixa de texto usado para inserir um número de telefone.For example, the following specifies an input mask for a text box control used for entering a phone number.

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).When you create an input mask, you can use special characters to require that certain data be entered (for example, the area code for a phone number) and that other data be optional (such as a telephone extension). 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.These characters specify the type of data, such as a number or character, that you must enter for each character in the input mask.

Você pode definir uma máscara de entrada usando os caracteres a seguir.You can define an input mask by using the following characters.

CaractereCharacter DescriçãoDescription
0 Dígito (0 a 9, entrada obrigatória; mais [+] e menos [?] sinais não permitidos).Digit (0 to 9, entry required; plus [+] and minus [?] signs not allowed).
9 Dígito ou espaço (entrada não obrigatória; sinais de mais e menos não são permitidos).Digit or space (entry not required; plus and minus signs not allowed).
# 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).Digit or space (entry not required; spaces are displayed as blanks while in Edit mode, but blanks are removed when data is saved; plus and minus signs allowed).
L Letra (A a Z, entrada obrigatória).Letter (A to Z, entry required).
? Letra (A a Z, entrada opcional).Letter (A to Z, entry optional).
A Letra ou dígito (entrada obrigatória).Letter or digit (entry required).
a Letra ou dígito (entrada opcional).Letter or digit (entry optional).
& Qualquer caractere ou um espaço (entrada obrigatória).Any character or a space (entry required).
C Qualquer caractere ou um espaço (entrada opcional).Any character or a space (entry optional).
. , : ; - / Marcador decimal e separadores de milhares, de data e de hora.Decimal placeholder and thousand, date, and time separators. (O caractere real usado depende das configurações da caixa de diálogo Propriedades das configurações regionais no painel de controle do Windows).(The actual character used depends on the settings in the Regional Settings Properties dialog box in the Windows Control Panel).
< Faz com que todos os caracteres sejam convertidos em minúsculas.Causes all characters to be converted to lowercase.
> Faz com que todos os caracteres sejam convertidos em maiúsculas.Causes all characters to be converted to uppercase.
! Faz com que a máscara de entrada seja exibida da direita para a esquerda, em vez de da esquerda para a direita.Causes the input mask to display from right to left, rather than from left to right. Os caracteres digitados na máscara sempre a preenchem da esquerda para a direita.Characters typed into the mask always fill it from left to right. Você pode incluir o ponto de exclamação em qualquer lugar da máscara de entrada.You can include the exclamation point anywhere in the input mask.
\ Faz com que o caractere seguinte seja exibido como o caractere literal (por exemplo, \A é exibido como A).Causes the character that follows to be displayed as the literal character (for example, \A is displayed as just A).

Observação

A configuração da propriedade InputMask com a palavra "Password" cria um controle de entrada de senha.Setting the InputMask property to the word "Password" creates a password-entry control. Qualquer caractere digitado no controle é armazenado como um caractere, mas é exibido como um asterisco (*).Any character typed in the control is stored as the character but is displayed as an asterisk (*). Você pode usar a máscara de entrada de senha para impedir a exibição dos caracteres digitados na tela.You use the Password input mask to prevent displaying the typed characters on the screen.

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.When you type data in a field for which you've defined an input mask, the data is always entered in Overtype mode. Se você usar a tecla backspace para excluir um caractere, o caractere será substituído por um espaço em branco.If you use the Backspace key to delete a character, the character is replaced by a blank space.

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.If you move text from a field for which you've defined an input mask onto the Clipboard, the literal display characters are copied, even if you have specified that they not be saved with data.

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.Only characters that you type directly in a control or combo box are affected by the input mask. O Access ignora qualquer máscara de entrada quando você importa dados, executa uma consulta ação ou insere caracteres em um controle definindo a propriedade Text do controle no Visual Basic ou usando a ação DefinirValor em uma macro.Access ignores any input masks when you import data, run an action query, or enter characters in a control by setting the control's Text property in Visual Basic or by using the SetValue action in a 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.When you've defined an input mask and set the Format property for the same field, the Format property takes precedence when the data is displayed. 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.This means that even if you've saved an input mask, the input mask is ignored when data is formatted and displayed. Os dados da tabela subjacente em si não serão alterados; a propriedade Format afeta apenas a exibição dos dados.The data in the underlying table itself isn't changed; the Format property affects only how the data is displayed.

A tabela a seguir mostra algumas máscaras de entrada úteis e os tipos de valores que você pode inserir nelas.The following table shows some useful input masks and the type of values that you can enter in them.

Máscara de entradaInput mask Valores de exemploSample values
(000) 000-0000(000) 000-0000 (206) 555-0248(206) 555-0248
(999) 999-9999(999) 999-9999 (206) 555-0248, () 555-0248(206) 555-0248, ( ) 555-0248
(000) AAA-AAAA(000) AAA-AAAA (206) 555-TELE(206) 555-TELE
#999#999 ? 20, 2000?20, 2000
>L????L?000L0>L????L?000L0 GREENGR339M3, MAIO DE 452B7GREENGR339M3, MAY R 452B7
>L0L 0L0>L0L 0L0 T2F 8M4T2F 8M4
00000-999900000-9999 98115-, 98115-300798115-, 98115-3007
>L<??????????????>L<?????????????? Maria, BrendanMaria, Brendan
SSN 000-00-0000SSN 000-00-0000 SSN 555-55-5555SSN 555-55-5555
>LL00000-0000>LL00000-0000 DB51392-0493DB51392-0493

Suporte e comentáriosSupport and feedback

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação?Have questions or feedback about Office VBA or this documentation? 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.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.