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.
• 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)	-
BlockDomain	List(Of String)	-
Desabilitado	Booleano	Se verdadeiro, desabilita o controle no tempo de execução.
Oculto	Booleano	Se verdadeiro, oculta o controle no tempo de execução.
HintText	String	O texto de ajuda a ser exibido no tempo de execução.
ÉVálido	Booleano	Obtém o status de validação.
Label	String	Rótulo acompanhado do texto.
MinLength	Número inteiro	Comprimento mínimo de caracteres do texto que deve estar presente no valor.
TamanhoMáx	Número inteiro	Comprimento máximo de caracteres do texto que deve estar presente no valor.
PatternRegex	String	Obtenha o regex padrão fornecido em Propriedades gerais.
Required	Booleano	Se verdadeiro , o campo não pode ficar vazio.
Dica de ferramenta	String	Obtém a cadeia de caracteres de dica de ferramenta.
Tipo	String	-
Valor	String	Acessa o valor dentro do campo.

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. In UiPath^® Apps, create a new app and import the downloaded demo app.
2. Visualize o aplicativo para interagir com as propriedades do controle Caixa de texto.