Элемент управления "Текстовое поле" в PowerAppsText input control in PowerApps

Поле, в котором пользователь может вводить текст, числа и другие данные.A box in which the user can type text, numbers, and other data.

ОписаниеDescription

Пользователь может вводить данные в элементе управления "Текстовое поле".The user can specify data by typing into a text-input control. В зависимости от настройки приложения эти данные могут добавляться в источник, использоваться для вычисления временного значения или применяться иным способом.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.

Основные свойстваKey properties

Default — начальное значение элемента управления до его изменения пользователем.Default – The initial value of a control before it is changed by the user.

Text — текст, отображаемый в элементе управления, или текст, который пользователь вводит в элемент управления.Text – Text that appears on a control or that the user types into a control.

Дополнительные свойстваAdditional properties

Align — расположение текста относительно центра элемента управления по горизонтали.Align – The location of text in relation to the horizontal center of its control.

BorderColor — цвет границы элемента управления.BorderColor – The color of a control's border.

BorderStyle — стиль границы элемента управления: Сплошная, Штриховая, Пунктирная или Отсутствует.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness — толщина границы элемента управления.BorderThickness – The thickness of a control's border.

FocusedBorderThickness — толщина границы элемента управления, когда он находится в фокусе.FocusedBorderThickness – The thickness of the control's border when it has keyboard focus.

Clear — определяет, отображается ли в текстовом поле значок "X", с помощью которого пользователь может очистить содержимое элемента управления.Clear – Whether a text-input control shows an "X" that the user can tap or click to clear the contents of that control.

Color — цвет текста в элементе управления.Color – The color of text in a control.

DelayOutput — при значении true вводимые пользователем данные регистрируются после задержки в половину секунды.DelayOutput – When set to true, user input is registered after half a second delay. Можно задерживать ресурсоемкие операции, пока пользователь не завершит ввод текста (например, для фильтрации, если входные данные используются в других формулах).Useful for delaying expensive operations until user completes inputting text (i.e. for filtering when input is used in other formulas).

DisplayMode — в зависимости от значения этого режима элемент управления разрешает пользователю вводить данные (Изменение), только отображает данные (Просмотр) или элемент вообще отключен (Отключено).DisplayMode – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

DisabledBorderColor — цвет границы элемента управления, если для его свойства DisplayMode установлено значение Отключено.DisabledBorderColor – The color of a control's border if the control's DisplayMode property is set to Disabled.

DisabledColor — цвет текста в элементе управления, если для его свойства DisplayMode установлено значение Отключено.DisabledColor – The color of text in a control if its DisplayMode property is set to Disabled.

DisabledFill — цвет фона элемента управления, если для его свойства DisplayMode установлено значение Отключено.DisabledFill – The background color of a control if its DisplayMode property is set to Disabled.

Fill — цвет фона элемента управления.Fill – The background color of a control.

Font — имя семейства шрифтов, используемых для отображения текста.Font – The name of the family of fonts in which text appears.

FontWeight — толщина текста в элементе управления: Жирный, Полужирный, Обычный или Очень тонкий.FontWeight – The weight of the text in a control: Bold, Semibold, Normal, or Lighter.

Format — это значение определяет, может ли пользователь вводить только цифры или любой другой текст.Format – Whether the user input is restricted to numbers only or can be any text.

Height — расстояние между верхним и нижним краем элемента управления.Height – The distance between a control's top and bottom edges.

HintText — текст светло-серого цвета, отображаемый в пустом текстовом поле.HintText – Light-grey text that appears in an input-text control if it's empty.

HoverBorderColor — цвет границы элемента управления при удерживании указателя мыши на нем.HoverBorderColor – The color of a control's border when the user keeps the mouse pointer on that control.

HoverColor — цвет текста в элементе управления при удерживании указателя мыши на нем.HoverColor – The color of the text in a control when the user keeps the mouse pointer on it.

HoverFill — цвет фона элемента управления при удерживании указателя мыши на нем.HoverFill – The background color of a control when the user keeps the mouse pointer on it.

Italic определяет, когда текст в элементе управления отображается курсивом.Italic – Whether the text in a control is italic.

LineHeight — расстояние, например, между строками текста или элементами списка.LineHeight – The distance between, for example, lines of text or items in a list.

MaxLength — количество символов, которые может ввести пользователь в элементе управления "Текстовое поле".MaxLength – The number of characters that the user can type into a text-input control.

Mode — определяет режим SingleLine (Однострочный), MultiLine (Многострочный) или Password (Пароль).Mode – The control is in SingleLine, MultiLine, or Password mode.

OnChange — поведение приложения, когда пользователь изменяет значение элемента управления (например, перемещая ползунок).OnChange – How the app responds when the user changes the value of a control (for example, by adjusting a slider).

OnSelect — поведение приложения, когда пользователь щелкает элемент управления или касается его.OnSelect – How the app responds when the user taps or clicks a control.

PaddingBottom — расстояние между текстом в элементе управления и нижним краем элемента управления.PaddingBottom – The distance between text in a control and the bottom edge of that control.

PaddingLeft — расстояние между текстом в элементе управления и левым краем элемента управления.PaddingLeft – The distance between text in a control and the left edge of that control.

PaddingRight — расстояние между текстом в элементе управления и правым краем элемента управления.PaddingRight – The distance between text in a control and the right edge of that control.

PaddingTop — расстояние между текстом в элементе управления и верхним краем элемента управления.PaddingTop – The distance between text in a control and the top edge of that control.

PressedBorderColor — цвет границы элемента управления при щелчке или касании.PressedBorderColor – The color of a control's border when the user taps or clicks that control.

PressedColor — цвет текста в элементе управления при щелчке или касании.PressedColor – The color of text in a control when the user taps or clicks that control.

PressedFill — цвет фона элемента управления при щелчке или касании.PressedFill – The background color of a control when the user taps or clicks that control.

RadiusBottomLeft — градус скругления нижнего левого угла элемента управления.RadiusBottomLeft – The degree to which the bottom-left corner of a control is rounded.

RadiusBottomRight — градус скругления нижнего правого угла элемента управления.RadiusBottomRight – The degree to which the bottom-right corner of a control is rounded.

RadiusTopLeft — градус, до которого округляется верхний левый угол элемента управления.RadiusTopLeft – The degree to which the top-left corner of a control is rounded.

RadiusTopRight — градус скругления верхнего правого угла элемента управления.RadiusTopRight – The degree to which the top-right corner of a control is rounded.

Reset — определяет, возвращается ли элемент управления к значению по умолчанию.Reset – Whether a control reverts to its default value.

Size — размер шрифта текста, отображаемого в элементе управления.Size – The font size of the text that appears on a control.

Strikethrough определяет, когда через текст, отображаемый в элементе управления, проходит линия.Strikethrough – Whether a line appears through the text that appears on a control.

TabIndex — ненулевое значение определяет последовательность перехода между элементами управления с помощью клавиши TAB.TabIndex – Customizes the tab order of controls at runtime when set to a non-zero value.

Tooltip — пояснительный текст, отображаемый при наведении указателя мыши на элемент управления.Tooltip – Explanatory text that appears when the user hovers over a control.

Underline определяет, когда под текстом, отображаемым в элементе управления, проходит линия.Underline – Whether a line appears under the text that appears on a control.

Visible определяет, отображается ли элемент управления или он скрыт.Visible – Whether a control appears or is hidden.

Width — расстояние между левым и правым краем элемента управления.Width – The distance between a control's left and right edges.

X — расстояние между левым краем элемента управления и левым краем его родительского контейнера (или экрана, если родительского контейнера нет).X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

Y — расстояние между верхним краем элемента управления и верхним краем его родительского контейнера (или экрана, если родительского контейнера нет).Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).

DateTimeValue(строка)DateTimeValue( String )

ПримерыExamples

Сбор данныхCollect data

  1. Добавьте два элемента управления "Текстовое поле" и назовите их inputFirst и inputLast.Add two text-input controls, and name them inputFirst and inputLast.

    Не знаете, как добавить, назвать и настроить элемент управления?Don't know how to add, name, and configure a control?

  2. Добавьте кнопку, укажите для ее свойства Text значение Добавить, а для свойства OnSelect следующую формулу: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})

    Нужны дополнительные сведения о функции Collect или других функциях?Want more information about the Collect function or other functions?

  3. Добавьте коллекцию текстов в портретной (вертикальной) ориентации, укажите для свойства Items значение Names, а для свойства Text элемента Subtitle1 значение 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. (Необязательно.) В коллекции шаблонов удалите нижнюю метку с именем Body1 и укажите для свойства TemplateSize коллекции значение 80.(optional) In the template gallery, delete the bottom label, named Body1, and set the TemplateSize property of the gallery to 80.
  5. Нажмите клавишу F5, введите строку текста в элементах inputFirst и inputLast, затем нажмите кнопку Добавить.Press F5, type a string of text into inputFirst and inputLast, and then click or tap the Add button.
  6. (Необязательно) Добавьте другие имена в коллекцию, а затем нажмите клавишу ESC, чтобы вернуться в рабочую область по умолчанию.(optional) Add more names to the collection, and then press Esc to return to the default workspace.

Запрос пароляPrompt for a password

  1. Добавьте элемент управления "Текстовое поле", назовите его inputPassword и укажите для свойства Mode значение Password.Add a text-input control, name it inputPassword, and set its Mode property to Password.
  2. Добавьте метку и установите в ее свойстве Text формулу:Add a label, and set its Text property to this formula:
    If(inputPassword.Text = "P@ssw0rd", "Доступ предоставлен", "Доступ запрещен") If(inputPassword.Text = "P@ssw0rd", "Access granted", "Access denied")

    Нужны дополнительные сведения о функции If или других функциях?Want more information about the If function or other functions?

  3. Нажмите клавишу F5 и введите P@ssw0rd в элементе inputPassword.Press F5, and then type P@ssw0rd in inputPassword.

    Когда вы закончите вводить пароль, в метке вместо значения Доступ запрещен будет отображаться значение Доступ предоставлен.When you finish typing the password, the label stops showing Access denied and starts to show Access granted.

  4. Нажмите клавишу ESC, чтобы вернуться в рабочую область по умолчанию.To return to the default workspace, press Esc.
  5. (Необязательно) Добавьте стрелку, настройте ее для перехода на другой экран и отображайте только после того, как пользователь введет пароль.(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. (Необязательно) Добавьте кнопку, настройте ее свойство Text для отображения значения Войти, добавьте таймер и отключайте элемент управления "Текстовое поле" на определенное время, если пользователь вводит неправильный пароль и нажимает кнопку Войти.(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.