Uma caixa em que o usuário pode digitar texto, números e outros dados.

Descrição

O usuário pode especificar dados digitando-os em um controle de entrada de texto. Dependendo de como você configura o aplicativo, esses dados podem ser adicionados a uma fonte de dados usada para calcular um valor temporário ou incorporados de alguma outra forma.

Propriedades-chave

Default – o valor inicial de um controle antes de ele ser alterado pelo usuário.

Text – texto que aparece em um controle ou que o usuário digita em um controle.

Propriedades adicionais

Align – a localização do texto em relação ao centro horizontal do respectivo controle.

BorderColor – a cor da borda do controle.

BorderStyle – se a borda do controle é Solid, Dashed, Dotted ou None.

BorderThickness – a espessura da borda do controle.

FocusedBorderThickness – a espessura da borda do controle quando ele tem o foco do teclado.

Desmarcar – se um controle de entrada de texto mostra um “X” no qual o usuário pode tocar ou clicar para desmarcar o conteúdo desse controle.

Color – a cor do texto em um controle.

DelayOutput – quando definido como true, a entrada do usuário é registrada após um atraso de meio segundo. É útil para atrasar operações caras até que o usuário preencha o texto de entrada (ou seja, para filtragem de entrada quando é usado em outras fórmulas).

Disabled – se o usuário pode ou não interagir com o controle.

DisabledBorderColor – a cor da borda do controle se a propriedade Disabled do controle estiver definida como true.

DisabledColor – a cor do texto em um controle se sua propriedade Disabled estiver definida como true.

DisabledFill – a cor da tela de fundo de um controle se sua propriedade Disabled estiver definida como true.

Fill – a cor da tela de fundo de um controle.

Font – o nome da família de fontes no qual o texto é exibido.

FontWeight – o peso do texto em um controle: Bold (negrito), Semibold, Normal ou Lighter (mais leve).

Height – a distância entre a parte superior do controle e as bordas inferiores.

HintText – texto cinza claro que é exibido em um controle de texto de entrada se ele estiver vazio.

HoverBorderColor – a cor da borda do controle quando o usuário mantém o ponteiro do mouse nesse controle.

HoverColor – a cor do texto em um controle quando o usuário mantém o ponteiro do mouse sobre ele.

HoverFill – a cor da tela de fundo de um controle quando o usuário mantém o ponteiro do mouse sobre ele.

Italic – se o texto em um controle está em itálico.

LineHeight – a distância entre, por exemplo, linhas de texto ou itens em uma lista.

MaxLength – o número de caracteres que o usuário pode digitar em um controle de entrada de texto.

Modo – o controle está no modo SingleLine, MultiLine ou Password.

OnChange – como o aplicativo responde quando o usuário altera o valor de um controle (por exemplo, ajustando um controle deslizante).

OnSelect – como o aplicativo responde quando o usuário toca ou clica em um controle.

PaddingBottom – a distância entre o texto em um controle e a borda inferior desse controle.

PaddingLeft – a distância entre o texto em um controle e a borda esquerda desse controle.

PaddingRight – a distância entre o texto em um controle e a borda direita desse controle.

PaddingTop – a distância entre o texto em um controle e a borda superior desse controle.

PressedBorderColor – a cor da borda do controle quando o usuário toca ou clica nesse controle.

PressedColor – a cor do texto em um controle quando o usuário toca ou clica nesse controle.

PressedFill – a cor da tela de fundo de um controle quando o usuário toca ou clica nesse controle.

RadiusBottomLeft – o grau para o qual o canto inferior esquerdo de um controle é arredondado.

RadiusBottomRight – o grau para o qual o canto inferior direito de um controle é arredondado.

RadiusTopLeft – o grau para o qual o canto superior esquerdo de um controle é arredondado.

RadiusTopRight – o grau para o qual o canto superior direito de um controle é arredondado.

Reset – se um controle é revertido para seu valor padrão.

Size – o tamanho da fonte do texto que aparece em um controle.

Strikethrough – se uma linha é exibida cortando o texto que aparece em um controle.

TabIndex – personaliza a ordem de tabulação de controles em tempo de execução quando definida como um valor diferente de zero.

Tooltip – um texto explicativo aparece quando o usuário passa o mouse sobre um controle.

Underline – se uma linha é exibida sob o texto que aparece em um controle.

Visible – se um controle é exibido ou está oculto.

Width – a distância entre das bordas esquerda e direita de um controle.

X – a distância entre a borda esquerda de um controle e a borda esquerda de seu contêiner pai (tela, se não houver contêiner pai).

Y – a distância entre a borda superior de um controle e a borda superior de seu contêiner pai (tela, se não houver contêiner pai).

Funções relacionadas

DateTimeValue( String )

Exemplos

Coletar dados

  1. Adicione dois controles de entrada de texto e nomeie-os inputFirst e inputLast.

    Não sabe como adicionar, nomear e configurar um controle?

  2. Adicione um botão, defina sua propriedade Text para Adde defina sua propriedade OnSelect conforme esta fórmula:
    Collect(Names, {FirstName:inputFirst.Text, LastName:inputLast.Text})

    Deseja obter mais informações sobre a função Collect ou outras funções?

  3. Adicionar uma galeria de texto na orientação retrato/vertical, defina sua propriedade Items como Namese defina a propriedade Text de Subtitle1 para ThisItem.FirstName.

  4. (opcional) Na galeria de modelos, exclua o rótulo inferior, chamado Body1, e defina a propriedade TemplateSize da galeria como 80.

  5. Pressione F5, digite uma cadeia de caracteres de texto em inputFirst e inputLaste, em seguida, clique ou toque no botão Adicionar.

  6. (opcional) Adicionar mais nomes à coleção e, em seguida, pressione Esc para retornar ao espaço de trabalho padrão.

Solicitar uma senha

  1. Adicionar um controle de entrada de texto, nomeie-o inputPassworde defina sua propriedade Mode como Password.

  2. Adicione um rótulo e defina sua propriedade Text como esta fórmula:
    If(inputPassword.Text = "P@ssw0rd", "Acesso permitido", "Acesso negado")

    Deseja saber mais sobre a função If ou sobre outras funções?

  3. Pressione F5 e, em seguida, digite P@ssw0rd em inputPassword.

    Quando terminar de digitar a senha, o rótulo parará de mostrar Acesso negado e começará a mostrar Acesso concedido.

  4. Para retornar ao espaço de trabalho padrão, pressione Esc.

  5. (opcional) Adicionar um controle como uma seta, configurá-lo para navegar para outra tela e mostrá-lo somente depois que o usuário digita a senha.

  6. (opcional) Adicione um botão, configure a propriedade Texto para mostrar Entrar, adicione um temporizador e desabilite o controle de texto de entrada para um determinado período de tempo se o usuário digita a senha incorreta e, em seguida, clique ou toque no botão Entrar.