Power Apps 中的 笔输入 控件

用户可用其进行绘图、擦除和突出显示图像区域的控件。

描述

用户可以像使用白板一样来使用该控件,绘制关系图和写字都能被转换为键入的文本。

限制

笔输入控件具有以下限制:

  • 在 Windows 应用中,笔控件仅部分支持用鼠标绘图或触控输入。 笔划可能不连贯。 要顺畅绘制,请使用触笔或在浏览器中运行应用。

键属性

图像 – 输出属性,表示由最终用户绘制的图像。

Color – 输入笔划的颜色。

Mode – 控件所处的 DrawErase 模式。 已弃用“选择”模式。

其他属性

AccessibleLabel – 屏幕阅读器标签。 可以用于描述控件的用途以及输入的替代方法。

BorderColor – 控件边框的颜色。

BorderStyle – 控件边框是 SolidDashedDotted 还是 None

BorderThickness – 控件边框的粗细。

DisplayMode – 此控件是允许用户输入 (Edit)、仅显示数据 (View),还是已禁用 (Disabled)。

Fill – 控件的背景色。

Height – 控件上边缘和下边缘之间的距离。

Input已弃用。 输入是否支持鼠标、触笔或触控输入。 默认值 (7) 支持上述所有三项。

OnSelect – 当用户点击或单击控件时要执行的操作。

SelectionColor – 所选项目或列表中项目的文本颜色,或笔控件中选择工具的颜色。

SelectionThickness – 笔输入 控件的选择工具的粗细。

ShowControls – 音频或视频播放器是否显示播放按钮和音量滑块等组件,笔控件是否显示绘图、擦除和清除图标等。

Size – 控件上显示的文本的字号。

Tooltip – 用户将鼠标悬停在控件上时显示的解释性文本。

Visible – 控件显示还是隐藏。

Width – 控件左边缘和右边缘之间的距离。

X – 控件左边缘与其父容器(如果没有父容器,则为屏幕)左边缘之间的距离。

Y – 控件上边缘与其父容器(如果没有父容器,则为屏幕)上边缘之间的距离。

Collect( CollectionName, DatatoCollect )

示例

创建一组图像

  1. 添加笔输入控件,将其命名为 MyDoodles,然后将其 ShowControls 属性设置为 true

    不知道如何添加、命名和配置控件

  2. 添加 按钮 控件,将其移到 MyDoodles 下方,然后设置 按钮 控件的**Text** 属性,使其显示为添加

  3. 将此 按钮 控件的 OnSelect 属性设置为以下公式:
    Collect(Doodles, {Sketch:MyDoodles.Image})

  4. 添加 图像库 控件,将其移到 按钮 控件下方,然后缩小 图像库 控件的宽度,直至它显示三个项。

  5. 图像库 控件的 Items 性设置为 Doodles,然后再按 F5。

  6. MyDoodles 中绘制图像,然后单击或点击 按钮 控件。

    绘制的图像将在 图像库 控件中显示。

  7. (可选)在笔输入控件中,单击或点击图标,清除所绘制的图像,绘制另一个图像,再单击或点击 按钮 控件。

  8. 图像库控件中,将 图像 控件的 OnSelect 属性设置为以下公式:
    Remove(Doodles, ThisItem)

  9. 单击或点击 图像库 控件中的绘图,可将其删除。

使用 SaveData 函数本地保存绘图,或使用 Patch 函数将其保存至数据源。

辅助功能准则

颜色对比度

在以下项之间必须有足够的颜色对比度:

  • BorderColor 和控件范围之外的颜色(如果有边框)
  • Fill 和控件范围之外的颜色(如果没有边框)

屏幕阅读器支持

  • AccessibleLabel 应存在。

    重要

    屏幕阅读器用户无法访问笔输入。 始终提供输入的替代形式。 例如,如果需要草图,请考虑添加 添加图片 控件,以便用户上传图像。 可以提供这两种方法,用户可以选择他们更熟悉的一种方法。

键盘支持

重要

键盘用户无法访问笔输入。 始终提供输入的替代形式。 例如,如果需要签名,请考虑添加 文本输入,以便用户输入其名称。 可以提供这两种方法,用户可以选择他们更熟悉的一种方法。

备注

您能告诉我们您的文档语言首选项吗? 进行简短调查。(请注意,此调查是英文版调查)

此调查大约需要七分钟。 不会收集个人数据(隐私声明)。