Caixa de texto

Geral

• Texto de dica — o texto de ajuda a ser exibido no tempo de execução.
• Texto padrão — o conteúdo padrão a ser exibido no tempo de execução.

  Se essa propriedade estiver vinculada a uma variável do aplicativo, as alterações no valor padrão não serão propagadas para a variável do aplicativo.

  • Para atualizar valores em variáveis do aplicativo, você deve usar uma regra Definir valor .

• Dica de ferramenta — Dica de ferramenta a ser exibida na área de texto. Use a dica para fornecer informações adicionais sobre o controle.
• Rótulo — o texto de exibição do controle.
• Separador de milhar — adiciona um separador para controles numéricos, permitindo que você exiba números grandes em um formato mais legível (por exemplo, 1,000 ao invés de 1000).
• Prefixo — adiciona uma opção de prefixo de moeda para caixas de texto numéricas, permitindo exibir um prefixo estático (como $ ou USD) à esquerda do número. O prefixo aceita texto livre de até 3 caracteres.
• Obrigatório — se verdadeiro, os usuários de aplicativos devem fornecer dados no controle. Para marcar o controle como obrigatório no tempo de execução, um asterisco * é adicionado após o texto do rótulo.
• Comprimento mínimo — o número mínimo de caracteres que os usuários precisam inserir.
• Comprimento máximo — o número máximo de caracteres que os usuários precisam inserir.
• Padrão (Regex) — a expressão Regex usada para validar diferentes padrões de entrada. Use barras comuns / / para encapsular a expressão Regex, por exemplo /{REGEX}/. Se um Regex inválido for fornecido, nenhuma validação será realizada no tempo de execução. Verifique os seguintes exemplos para obter expressões Regex válidas:

  Expressão Regex	O que é validado
  /\d/	O texto deve conter números
  /^\d*$/	O texto deve conter apenas números
  /\w/	O texto deve conter caracteres alfabéticos (ele sempre corresponde aos caracteres ASCII [A-Za-z0-9_])
  /[A-G]/	O texto deve conter caracteres de A a G
  /^C\d{7}$/	O texto deve começar com a letra C seguida de 7 caracteres numéricos.
  /^.{6,10}$/	O texto deve estar entre 6 e 10 .
  /[A-H0-5_@?]/	O texto contém apenas caracteres de A a H, 0 a 5, _, @ e ?
  /^4[0-9]{12}(?:[0-9]{3})?$/	O texto é um número de cartão de crédito Visa.
  /^3[47][0-9]{13}$/	O texto é um número de cartão de crédito American Express.
  /^5[1-5][0-9]{14}|^(222[1-9]|22[3-9]\\d|2[3-6]\\d{2}|27[0-1]\\d|2720)[0-9]{12}$/	O texto é um número de cartão de crédito MasterCard.
  /^([+]?\d{1,2}[-\s]?|)\d{3}[-\s]?\d{3}[-\s]?\d{4}$/	O texto é um número de telefone com código de país opcional, caracteres especiais opcionais e espaço em branco.
  /^(0[1-9]|[1-2][0-9]|3[0-1])\/(0[1-9]|1[0-2])\/(\d{4})$/	O texto é uma data de nascimento válida no formato DD/MM/YYYY.

• Mensagem de erro personalizada - o texto a ser exibido se a propriedade Obrigatório estiver definida como verdadeira e o controle for deixado vazio.
• Oculto — se verdadeiro, oculta o controle no tempo de execução.
• Desabilitado — se verdadeiro, desabilita o controle no tempo de execução.

Events

• Valor alterado — configure o que deve acontecer quando o texto é alterado.

Estilo

• Alinhamento de controle — Por padrão, herda o alinhamento pai. É possível definir outro alinhamento que não o pai. Para voltar ao alinhamento padrão pai, desmarque as opções substituídas.

  Observação: o alinhamento depende do layout selecionado para o pai (Vertical vs Horizontal).
• Posicionamento do rótulo — por padrão, o rótulo é definido para ser exibido na parte superior do controle, no lado esquerdo. Você pode colocá-lo à esquerda do controle, na mesma linha. A propriedade Largura do rótulo configura a largura do rótulo e a propriedade Espaço entre define a distância entre o rótulo e o controle.
• Cor de fundo — a cor em segundo plano do controle. Você pode definir uma cor fixa usando o seletor de cores ou definir um valor dinâmico usando uma expressão VB.

• Fonte — os atributos de fonte para o rótulo e o texto de entrada, como família de fontes, tamanho, cor ou estilo (Necessário, Itálico e Sublinhado) ou alinhamento de texto. Por padrão, o controle herda a família de fontes do contêiner pai imediato, que é indicado pela palavra-chave “herdado”.

• Margem — a margem do controle. Por padrão, uma margem de 4px é definida. As propriedades de margem Top/Bottom (Superior/Inferior) e Left/Right (Esquerda/Direita) são combinadas. Essas propriedades podem ser desanexadas usando o botão Link no lado direito da seção Margem.
• Tamanho — a largura e a altura do controle. Por padrão, o tamanho é definido como auto. Para definir valores mínimos ou máximos, clique no ícone de três pontos (...). Se o tamanho do controle for menor que as opções, será exibida uma barra de rolagem.

Propriedades VB

Propriedade do VB	Tipo de dados	Description
AllowDomain	List(Of String)	Lista de domínios permitidos.
BlockDomain	List(Of String)	Lista de domínios bloqueados.
Type	String	-
PatternRegex	String	Recupera a expressão regular (regex) fornecida nas propriedades Gerais do controle. Usado para validar a entrada do usuário.
Label	String	O rótulo da caixa de texto controle, geralmente texto exibido antes do controle.
HintText	String	Texto do espaço reservado exibido ao usuário sobre o controle Caixa de texto.
Tooltip	String	Texto informativo que aparece quando o usuário passa o mouse sobre o controle.
Value	String	O valor atualmente selecionado da Caixa de texto controle.
MinLength	Número inteiro	O número mínimo de caracteres que o usuário deve inserir.
MaxLength	Número inteiro	O número máximo de caracteres que os usuários podem inserir.
Required	Booleano	Especifica se o valor da Caixa de texto é obrigatório.
Hidden	Booleano	Se verdadeiro, oculta o controle no tempo de execução.
Disabled	Booleano	Se verdadeiro, desabilita a interação com o controle no tempo de execução.
IsValid	Booleano	Verifica a validade do valor da Caixa de texto. Se verdadeiro, indica que é válido.