Power Apps 中的 笔输入 控件
用户可用其进行绘图、擦除和突出显示图像区域的控件。
描述
用户可以像使用白板一样来使用该控件,绘制关系图和写字都能被转换为键入的文本。
限制
笔输入控件具有以下限制:
- 在 Windows 应用中,笔控件仅部分支持用鼠标绘图或触控输入。 笔划可能不连贯。 要顺畅绘制,请使用触笔或在浏览器中运行应用。
键属性
图像 – 输出属性,表示由最终用户绘制的图像。
Color – 输入笔划的颜色。
Mode – 控件所处的 Draw 或 Erase 模式。 已弃用“选择”模式。
其他属性
AccessibleLabel – 屏幕阅读器标签。 可以用于描述控件的用途以及输入的替代方法。
BorderColor – 控件边框的颜色。
BorderStyle – 控件边框是 Solid、Dashed、Dotted 还是 None。
BorderThickness – 控件边框的粗细。
DisplayMode – 此控件是允许用户输入 (Edit)、仅显示数据 (View),还是已禁用 (Disabled)。
Fill – 控件的背景色。
Height – 控件上边缘和下边缘之间的距离。
Input – 已弃用。 输入是否支持鼠标、触笔或触控输入。 默认值 (7) 支持上述所有三项。
OnSelect – 当用户点击或单击控件时要执行的操作。
SelectionColor – 所选项目或列表中项目的文本颜色,或笔控件中选择工具的颜色。
SelectionThickness – 笔输入 控件的选择工具的粗细。
ShowControls – 音频或视频播放器是否显示播放按钮和音量滑块等组件,笔控件是否显示绘图、擦除和清除图标等。
Size – 控件上显示的文本的字号。
Tooltip – 用户将鼠标悬停在控件上时显示的解释性文本。
Visible – 控件显示还是隐藏。
Width – 控件左边缘和右边缘之间的距离。
X – 控件左边缘与其父容器(如果没有父容器,则为屏幕)左边缘之间的距离。
Y – 控件上边缘与其父容器(如果没有父容器,则为屏幕)上边缘之间的距离。
相关函数
Collect( CollectionName, DatatoCollect )
示例
创建一组图像
添加笔输入控件,将其命名为 MyDoodles,然后将其 ShowControls 属性设置为 true。
不知道如何添加、命名和配置控件?
将此 按钮 控件的 OnSelect 属性设置为以下公式:
Collect(Doodles, {Sketch:MyDoodles.Image})添加 图像库 控件,将其移到 按钮 控件下方,然后缩小 图像库 控件的宽度,直至它显示三个项。
将 图像库 控件的 Items 性设置为 Doodles,然后再按 F5。
在 MyDoodles 中绘制图像,然后单击或点击 按钮 控件。
绘制的图像将在 图像库 控件中显示。
(可选)在笔输入控件中,单击或点击图标,清除所绘制的图像,绘制另一个图像,再单击或点击 按钮 控件。
在图像库控件中,将 图像 控件的 OnSelect 属性设置为以下公式:
Remove(Doodles, ThisItem)单击或点击 图像库 控件中的绘图,可将其删除。
使用 SaveData 函数本地保存绘图,或使用 Patch 函数将其保存至数据源。
辅助功能准则
颜色对比度
在以下项之间必须有足够的颜色对比度:
- BorderColor 和控件范围之外的颜色(如果有边框)
- Fill 和控件范围之外的颜色(如果没有边框)
屏幕阅读器支持
AccessibleLabel 应存在。
重要
屏幕阅读器用户无法访问笔输入。 始终提供输入的替代形式。 例如,如果需要草图,请考虑添加 添加图片 控件,以便用户上传图像。 可以提供这两种方法,用户可以选择他们更熟悉的一种方法。
键盘支持
重要
键盘用户无法访问笔输入。 始终提供输入的替代形式。 例如,如果需要签名,请考虑添加 文本输入,以便用户输入其名称。 可以提供这两种方法,用户可以选择他们更熟悉的一种方法。