Controlo Introdução de texto no PowerAppsText input control in PowerApps

Uma caixa na qual o utilizador pode introduzir texto, números e outros dados.A box in which the user can type text, numbers, and other data.

DescriçãoDescription

O utilizador pode especificar dados escrevendo num controlo de introdução de texto.The user can specify data by typing into a text-input control. Dependendo de como configurar a aplicação, esses dados poderão ser adicionados a uma origem de dados, utilizados para calcular um valor temporário ou incorporados de outro modo.Depending on how you configure the app, that data might be added to a data source, used to calculate a temporary value, or incorporated in some other way.

Propriedades principaisKey properties

Default – o valor inicial de um controlo antes de ser alterado pelo utilizador.Default – The initial value of a control before it is changed by the user.

Texto – texto que é apresentado num controlo ou que o utilizador escreve num controlo.Text – Text that appears on a control or that the user types into a control.

Propriedades adicionaisAdditional properties

Alinhar – a localização de texto em relação ao centro horizontal do seu controlo.Align – The location of text in relation to the horizontal center of its control.

BorderColor – a cor do limite de um controlo.BorderColor – The color of a control's border.

BorderStyle – se o limite do controlo é Sólido, Tracejado, Com pontos ou Nenhum.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness – a espessura do limite de um controlo.BorderThickness – The thickness of a control's border.

FocusedBorderThickness – a espessura do limite do controlo quando tem o foco do teclado.FocusedBorderThickness – The thickness of the control's border when it has keyboard focus.

Limpar – se um controlo de introdução de texto mostra um "X" em que o utilizador pode tocar ou clicar para limpar o conteúdo desse controlo.Clear – Whether a text-input control shows an "X" that the user can tap or click to clear the contents of that control.

Cor – a cor do texto num controlo.Color – The color of text in a control.

DelayOutput - se definido como verdadeiro, a intervenção do utilizador fica registada após meio segundo de atraso.DelayOutput – When set to true, user input is registered after half a second delay. Útil para adiar operações dispendiosas até que o utilizador conclua a introdução de texto (ou seja, para filtragem quando a introdução é utilizada noutras fórmulas).Useful for delaying expensive operations until user completes inputting text (i.e. for filtering when input is used in other formulas).

DisplayMode – se o controlo permite a intervenção do utilizador (Editar), apenas apresenta os dados (Visualizar) ou está desativado (Desativado).DisplayMode – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

DisabledBorderColor – a cor do limite de um controlo se a propriedade DisplayMode do controlo estiver definida como Desativado.DisabledBorderColor – The color of a control's border if the control's DisplayMode property is set to Disabled.

DisabledColor – a cor do texto num controlo se a respetiva propriedade DisplayMode estiver definida como Desativado.DisabledColor – The color of text in a control if its DisplayMode property is set to Disabled.

DisabledFill – a cor de fundo de um controlo se a respetiva propriedade DisplayMode estiver definida como Desativado.DisabledFill – The background color of a control if its DisplayMode property is set to Disabled.

Preenchimento – a cor de fundo de um controlo.Fill – The background color of a control.

Tipo de letra – o nome da família dos tipos de letra que aparecem no texto.Font – The name of the family of fonts in which text appears.

FontWeight – a espessura do texto num controlo: Negrito, Seminegrito, Normal ou Mais claro.FontWeight – The weight of the text in a control: Bold, Semibold, Normal, or Lighter.

Formato – se a introdução pelo utilizador está restrita só a números ou se pode ser qualquer texto.Format – Whether the user input is restricted to numbers only or can be any text.

Altura – a distância entre as margens superiores e inferiores de um controlo.Height – The distance between a control's top and bottom edges.

HintText – texto em cinzento claro que aparece num controlo de introdução de texto, se estiver vazio.HintText – Light-grey text that appears in an input-text control if it's empty.

HoverBorderColor – a cor do limite de um controlo quando o utilizador mantém o ponteiro do rato nesse controlo.HoverBorderColor – The color of a control's border when the user keeps the mouse pointer on that control.

HoverColor – a cor do texto num controlo quando o utilizador mantém o ponteiro do rato no mesmo.HoverColor – The color of the text in a control when the user keeps the mouse pointer on it.

HoverFill – a cor de fundo de um controlo quando o utilizador mantém o ponteiro do rato no mesmo.HoverFill – The background color of a control when the user keeps the mouse pointer on it.

Itálico – se o texto num controlo é itálico.Italic – Whether the text in a control is italic.

LineHeight – a distância entre, por exemplo, as linhas de texto ou os itens numa lista.LineHeight – The distance between, for example, lines of text or items in a list.

MaxLength – o número de carateres que o utilizador pode escrever num controlo de introdução de texto.MaxLength – The number of characters that the user can type into a text-input control.

Modo – o controlo está no modo SingleLine, MultiLine ou Palavra-passe.Mode – The control is in SingleLine, MultiLine, or Password mode.

OnChange – como a aplicação responde quando o utilizador altera o valor de um controlo (por exemplo, ao ajustar um controlo de deslize).OnChange – How the app responds when the user changes the value of a control (for example, by adjusting a slider).

OnSelect – como a aplicação responde quando o utilizador toca ou clica num controlo.OnSelect – How the app responds when the user taps or clicks a control.

PaddingBottom – a distância entre o texto num controlo e o limite inferior desse controlo.PaddingBottom – The distance between text in a control and the bottom edge of that control.

PaddingLeft – a distância entre o texto num controlo e o limite esquerdo desse controlo.PaddingLeft – The distance between text in a control and the left edge of that control.

PaddingRight – a distância entre o texto num controlo e o limite direito desse controlo.PaddingRight – The distance between text in a control and the right edge of that control.

PaddingTop – a distância entre o texto num controlo e o limite superior desse controlo.PaddingTop – The distance between text in a control and the top edge of that control.

PressedBorderColor – a cor do limite de um controlo quando o utilizador toca ou clica nesse controlo.PressedBorderColor – The color of a control's border when the user taps or clicks that control.

PressedColor – a cor do texto num controlo quando o utilizador toca ou clica nesse controlo.PressedColor – The color of text in a control when the user taps or clicks that control.

PressedFill – a cor de fundo de um controlo quando o utilizador toca ou clica nesse controlo.PressedFill – The background color of a control when the user taps or clicks that control.

RadiusBottomLeft – o grau a que o canto inferior esquerdo de um controlo é arredondado.RadiusBottomLeft – The degree to which the bottom-left corner of a control is rounded.

RadiusBottomRight – o grau a que o canto inferior direito de um controlo é arredondado.RadiusBottomRight – The degree to which the bottom-right corner of a control is rounded.

RadiusTopLeft – o grau a que o canto superior esquerdo de um controlo é arredondado.RadiusTopLeft – The degree to which the top-left corner of a control is rounded.

RadiusTopRight – o grau a que o canto superior direito de um controlo é arredondado.RadiusTopRight – The degree to which the top-right corner of a control is rounded.

Reset – se um controlo é revertido para o valor predefinido.Reset – Whether a control reverts to its default value.

Tamanho – o tamanho do tipo de letra do texto que é apresentado num controlo.Size – The font size of the text that appears on a control.

Rasurado – se é apresentada uma linha no meio do texto que aparece num controlo.Strikethrough – Whether a line appears through the text that appears on a control.

TabIndex – personaliza a ordem dos separadores dos controlos durante o runtime, quando definido como um valor diferente de zero.TabIndex – Customizes the tab order of controls at runtime when set to a non-zero value.

Tooltip – o texto explicativo que aparece quando o rato passa por cima de um controlo.Tooltip – Explanatory text that appears when the user hovers over a control.

Sublinhado – se é apresentada uma linha sob o texto que aparece num controlo.Underline – Whether a line appears under the text that appears on a control.

Visível – se um controlo é apresentado ou está oculto.Visible – Whether a control appears or is hidden.

Largura – a distância entre as margens esquerda e direita de um controlo.Width – The distance between a control's left and right edges.

X – A distância entre o limite esquerdo de um controlo e o limite esquerdo do respetivo contentor principal (do ecrã, se não existir um contentor principal).X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

Y – A distância entre o limite superior de um controlo e o limite superior do contentor principal (do ecrã, se não existir um contentor principal).Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).

DateTimeValue( String )DateTimeValue( String )

ExemplosExamples

Recolher dadosCollect data

  1. Adicione dois controlos de introdução de texto e dê-lhes o nome inputFirst e inputLast.Add two text-input controls, and name them inputFirst and inputLast.

    Não sabe como adicionar, atribuir um nome e configurar um controlo?Don't know how to add, name, and configure a control?

  2. Adicione um botão, defina a respetiva propriedade Texto para Adicionar e defina a propriedade OnSelect para esta fórmula:Add a button, set its Text property to Add, and set its OnSelect property to this formula:
    Collect(Names, {FirstName:inputFirst.Text, LastName:inputLast.Text})Collect(Names, {FirstName:inputFirst.Text, LastName:inputLast.Text})

    Pretende obter mais informações sobre a função Collect ou outras funções?Want more information about the Collect function or other functions?

  3. Adicione uma galeria de texto na orientação retrato/vertical, defina a respetiva propriedade Itens para Nomes, e defina a propriedade Texto de Subtitle1 para ThisItem.FirstName.Add a text gallery in portrait/vertical orientation, set its Items property to Names, and set the Text property of Subtitle1 to ThisItem.FirstName.
  4. (opcional) Na galeria do modelo, elimine a etiqueta inferior, com o nome Body1e defina a propriedade TemplateSize da galeria para 80.(optional) In the template gallery, delete the bottom label, named Body1, and set the TemplateSize property of the gallery to 80.
  5. Prima F5, escreva uma cadeia de texto em inputFirst e inputLaste, em seguida, clique ou toque no botão Adicionar.Press F5, type a string of text into inputFirst and inputLast, and then click or tap the Add button.
  6. (opcional) Adicione mais nomes à coleção e, em seguida, prima Esc para regressar à área de trabalho predefinida.(optional) Add more names to the collection, and then press Esc to return to the default workspace.

Pedir uma palavra-passePrompt for a password

  1. Adicione um controlo de introdução de texto, dê-lhe o nome inputPassworde defina a respetiva propriedade Modo para Palavra-passe.Add a text-input control, name it inputPassword, and set its Mode property to Password.
  2. Adicione uma etiqueta e defina a respetiva propriedade Text como esta fórmula:Add a label, and set its Text property to this formula:
    If(inputPassword.Text = "P@ssw0rd", "Access granted", "Access denied")If(inputPassword.Text = "P@ssw0rd", "Access granted", "Access denied")

    Pretende obter mais informações sobre a função If ou outras funções?Want more information about the If function or other functions?

  3. Prima F5 e, em seguida, escreva P@ssw0rd em inputPassword.Press F5, and then type P@ssw0rd in inputPassword.

    Quando acabar de escrever a palavra-passe, a etiqueta deixa de mostrar Acesso negado e passa a mostrar Acesso concedido.When you finish typing the password, the label stops showing Access denied and starts to show Access granted.

  4. Para voltar à área de trabalho predefinida, prima Esc.To return to the default workspace, press Esc.
  5. (opcional) Adicione um controlo como uma seta, configure-o para navegar para outro ecrã e mostrá-lo apenas depois de o utilizador escrever a palavra-passe.(optional) Add a control such as an arrow, configure it to navigate to another screen, and show it only after the user types the password.
  6. (opcional) Adicione um botão, configure a respetiva propriedade Texto para que mostre Iniciar sessão, adicione um temporizador e desative o controlo de introdução de texto durante um determinado período de tempo se o utilizador escrever a palavra-passe incorreta e, em seguida, clica ou toque no botão Iniciar sessão.(optional) Add a button, configure its Text property to show Sign in, add a timer, and disable the input-text control for a certain amount of time if the user types the wrong password and then clicks or taps the Sign in button.