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.
• 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.

• Fonte — os atributos de fonte para o rótulo e o texto de entrada, como família de fontes, tamanho, cor ou estilo (negrito, itálico e sublinhado). 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.
Tipo	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.
Dica de ferramenta	String	Texto informativo que aparece quando o usuário passa o mouse sobre o controle.
Valor	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.
TamanhoMáx	Número inteiro	O número máximo de caracteres que os usuários podem inserir.
Required	Booleano	Especifica se o valor de Área de Texto é obrigatório.
Oculto	Booleano	Se verdadeiro, oculta o controle no tempo de execução.
Desabilitado	Booleano	Se verdadeiro, desabilita a interação com o controle no tempo de execução.
ÉVálido	Booleano	Verifica a validade do valor da Caixa de texto. Se verdadeiro, indica que é válido.

Demonstrações

Caixa de texto: descobrir propriedades específicas

Introdução

Este aplicativo mostra como aproveitar as propriedades de um controle Caixa de texto.

Aplicativo de demonstração – experimente você

Baixar aplicativo de demonstração do GitHub

Visualizar aplicativo de demonstração na nuvem

Aplicativo de demonstração — instruções para usar

1. No UiPath^® Apps, crie um novo aplicativo e importe o aplicativo de demonstração baixado.
2. Visualize o aplicativo para interagir com as propriedades do controle Caixa de texto.