Caixa de texto

Propriedades, opções de validação, eventos e propriedades VB do controle Caixa de texto para entrada de texto de linha única em aplicativos.

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 .

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 esta propriedade estiver vinculada a uma variável de aplicativo, as alterações feitas no valor padrão não serão propagadas para a variável de aplicativo.

  • Para atualizar valores em variáveis de 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.

• Hide characters - Available for the Text type only. Use it for passwords and other sensitive input. If selected, the control masks what app users type and shows an icon that reveals the text. Expressions and rules still receive the real value.

• 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 runtime. 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 parent. É 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 Top/Bottom e Left/Right 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 do controle Caixa de texto , normalmente o texto exibido precedendo o controle.
HintText	String	O texto do espaço reservado exibido ao usuário no controle da 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 do controle Caixa de texto .
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 for verdadeiro, indica que é válido.