用户可以在其中键入文本、数字和其他数据的框。
Description
用户可以通过键入文本输入控件来指定数据。 根据配置应用的方式,可将该数据添加到数据源、用于计算临时值或以某种其他方式合并。
键属性
默认值 – 用户更改控件之前控件的初始值。
文本 - 显示在控件上或用户键入控件的文本。
其他属性
AccessibleLabel – 屏幕阅读器标签。
对齐 - 文本相对于其控件的水平中心的位置。
BorderColor – 控件边框的颜色。
BorderStyle – 控件的边框是 Solid、 Dashed、 Dotted 还是 None。
BorderThickness – 控件边框的粗细。
清除 – 文本输入控件是否显示用户可以点击或单击以清除该控件的内容的“X”。 仅适用于 SingleLine 模式。
颜色 – 控件中的文本颜色。
DelayOutput – 设置为 true 时,用户输入在半秒延迟后注册。 有助于延迟昂贵的作,直到用户完成输入文本(即用于筛选输入在其他公式中使用时)。
DisplayMode – 控件是否允许用户输入(编辑)、仅显示数据(视图)或已禁用(已禁用)。
DisabledBorderColor – 如果控件的 DisplayMode 属性设置为 Disabled,则控件边框的颜色。
DisabledColor – 控件中的文本颜色(如果控件的 DisplayMode 属性设置为 Disabled)。
DisabledFill – 控件的 DisplayMode 属性设置为 Disabled 时的背景色。
EnableSpellCheck – 文本输入控件是否应使用浏览器拼写检查函数。 适用于 Windows 的 Power Apps 不支持此属性。
填充 – 控件的背景色。
FocusedBorderColor – 当控件聚焦时控件边框的颜色。
FocusedBorderThickness – 当控件聚焦时控件边框的粗细。
字体 – 显示文本的字体系列的名称。
FontWeight – 控件中文本的粗细: 粗体、 半曲、 普通或 较轻。
格式 – 用户输入是仅限于数字还是可以是任何文本。 设置为 数字时,只能输入数字和某些数字符号。 支持的符号和格式取决于浏览器语言,不能在单个控件上设置。
高度 – 控件的上边缘和下边缘之间的距离。
HintText – 如果为空,则显示在输入文本控件中的浅灰色文本。
HoverBorderColor – 当用户在该控件上保留鼠标指针时控件边框的颜色。
HoverColor – 当用户将鼠标指针放在控件上时,控件中文本的颜色。
HoverFill – 当用户将鼠标指针放在控件上时,控件的背景色。
斜体 – 控件中的文本是否为斜体。
LineHeight – 列表中的文本或项目行之间的距离。
MaxLength – 用户可以键入到文本输入控件中的字符数。
模式 – 控件处于 单行、 多行或 密码 模式。
OnChange – 当用户更改控件值时要执行的作(例如,通过调整滑块)。
OnSelect – 当用户点击或单击控件时要执行的作。
PaddingBottom – 控件中的文本与该控件的下边缘之间的距离。
PaddingLeft – 控件中的文本与该控件的左边缘之间的距离。
PaddingRight – 控件中的文本与该控件右边缘之间的距离。
PaddingTop – 控件中的文本与该控件的上边缘之间的距离。
PressedBorderColor – 当用户点击或单击该控件时控件边框的颜色。
PressedColor – 当用户点击或单击该控件时控件中的文本颜色。
PressedFill – 当用户点击或单击该控件时控件的背景色。
RadiusBottomLeft – 控件左下角舍入的程度。
RadiusBottomRight – 控件右下角舍入的程度。
RadiusTopLeft – 控件左上角舍入的程度。
RadiusTopRight – 控件右上角舍入的程度。
重置 – 控件是否还原为其默认值。
大小 – 控件上显示的文本的字号。
删除线 – 是否通过控件上显示的文本显示线条。
TabIndex – 相对于其他控件的键盘导航顺序。
工具提示 – 当用户将鼠标悬停在控件上时出现的解释性文本。
下划线 – 是否在控件上显示的文本下显示一行。
VirtualKeyboardMode – 在应用用户的触摸屏上显示的虚拟键盘、文本或数字类型。 Format 属性确定默认值。 设备支持各不相同。 运行 iOS 的设备必须至少具有版本 12.2。 建议的 Android 版本为 9.0,数字键盘的功能因 Android 设备而异。 Windows 10 不支持此属性。
可见 – 控件是显示还是隐藏。
宽度 – 控件的左边缘和右边缘之间的距离。
X – 控件左边缘与其父容器(如果没有父容器,则为屏幕)左边缘之间的距离。
Y – 控件上边缘与其父容器(如果没有父容器,则为屏幕)上边缘之间的距离。
相关函数
例子
收集数据
添加两个文本输入控件,并将其命名为 inputFirst 和 inputLast。
不知道如何 添加、命名和配置控件?
添加按钮,将其 Text 属性设置为 Add,并将其 OnSelect 属性设置为以下公式:
Collect(Names, {FirstName:inputFirst.Text, LastName:inputLast.Text})在纵向/垂直方向中添加文本库,将其 Items 属性设置为 Names,并将 Subtitle1 的 Text 属性设置为 ThisItem.FirstName。
(可选)在模板库中,删除名为 Body1 的底部标签,并将库的 TemplateSize 属性设置为 80。
按 F5,在 inputFirst 和 inputLast 中键入文本字符串,然后单击或点击“ 添加 ”按钮。
(可选)向集合添加更多名称,然后按 Esc 返回到默认工作区。
提示输入密码
添加文本输入控件,将其命名为 inputPassword,并将其 Mode 属性设置为 “密码”。
添加一个标签,然后将其 Text 属性设置为以下公式:
If(inputPassword.Text = “P@ssw0rd”, “Access granted”, “Access denied”)按 F5,然后在 inputPassword 中键入P@ssw0rd。
键入完密码后,标签将停止显示 “拒绝访问 ”,并开始显示 授予的访问权限。
若要返回到默认工作区,请按 Esc。
(可选)添加一个控件(如箭头),将其配置为导航到另一个屏幕,并且仅在用户键入密码后显示它。
(可选)添加按钮,配置其 Text 属性以显示 登录,添加计时器,并在用户键入错误密码时禁用输入文本控件,然后单击或点击 “登录 ”按钮。
辅助功能指南
颜色对比度
- 标准颜色对比度要求适用。
屏幕阅读器支持
- AccessibleLabel 必须存在。
键盘支持
- TabIndex 必须为零或更大,以便键盘用户可以导航到它。
- 焦点指示器必须清晰可见。 使用 FocusedBorderColor 和 FocusedBorderThickness 来实现此目的。