用户可以在其中绘制、擦除和突出显示图像区域的控件。
Description
用户可以使用此控件，如白板、绘制图表和编写可转换为类型化文本的字词。
局限性
笔输入控件具有以下限制：
- 笔控件仅对在 Windows 应用中使用鼠标或触摸输入进行绘图的部分支持。 笔划可能是间歇性的。 若要平滑绘制，请使用笔或在浏览器中运行应用。
键属性
Image – Output 属性，表示最终用户绘制的图像。
颜色 – 输入笔划的颜色。
模式 – 控件处于 “绘图 ”或 “擦除 ”模式。 选择模式已弃用。
其他属性
AccessibleLabel – 屏幕阅读器标签。 可用于描述控件的用途以及输入的替代方法。
BorderColor – 控件边框的颜色。
BorderStyle – 控件的边框是 Solid、 Dashed、 Dotted 还是 None。
BorderThickness – 控件边框的粗细。
DisplayMode – 控件是否允许用户输入（编辑）、仅显示数据（视图）或已禁用（已禁用）。
填充 – 控件的背景色。
高度 – 控件的上边缘和下边缘之间的距离。
输入 – 已弃用。 输入是否支持鼠标、笔或触摸输入。 默认值 （7） 支持这三个值。
OnSelect – 当用户点击或单击控件时要执行的作。
SelectionColor – 选定项或列表中的项的文本颜色，或笔控件中选定工具的颜色。
SelectionThickness – 笔输入控件的选择工具的粗细。
ShowControls – 音频或视频播放器是否显示，例如播放按钮和音量滑块，以及笔控件显示，例如用于绘图、擦除和清除的图标。
大小 – 控件上显示的文本的字号。
工具提示 – 当用户将鼠标悬停在控件上时出现的解释性文本。
可见 – 控件是显示还是隐藏。
宽度 – 控件的左边缘和右边缘之间的距离。
X – 控件左边缘与其父容器（如果没有父容器，则为屏幕）左边缘之间的距离。
Y – 控件上边缘与其父容器（如果没有父容器，则为屏幕）上边缘之间的距离。
相关函数
Collect（ CollectionName、 DatatoCollect ）
Example
创建一组映像
添加 Pen 输入 控件，将其命名为 MyDoodles，并将其 ShowControls 属性设置为 true。
不知道如何 添加、命名和配置控件？
将 Button 控件的 OnSelect 属性设置为以下公式：
Collect（涂鸦，{草图：MyDoodles.Image}）添加 图像库 控件，将其移动到 Button 控件下方，并缩小 图像库 控件的宽度，直到显示三个项目。
将图像库控件的 Items 属性设置为 Doodles，然后按 F5。
在 MyDoodles 中绘制图像，然后单击或点击 按钮 控件。
您绘制的图像将显示在 图像库 控件中。
（可选）在 触控笔输入 控件中，单击或点击图标以清除绘制的图像，绘制另一个图像，然后单击或点击 按钮 控件。
在 Image 库控件中，将 Image 控件的 OnSelect 属性设置为以下公式：
Remove（涂鸦，ThisItem）通过在 图像库 控件中单击或点击绘图来删除绘图。
使用 SaveData 函数在本地保存绘图，或使用 Patch 函数将其保存到数据源。
辅助功能指南
颜色对比度
在以下两者之间必须有足够的颜色对比度：
- BorderColor 和控件外的颜色（如果有边框）
- 填充 控件外的颜色（如果没有边框）
屏幕阅读器支持
应存在 AccessibleLabel。
重要
屏幕阅读器用户无法访问笔输入。 始终提供另一种输入形式。 例如，如果需要草图，请考虑为用户添加 添加图片 控件以上传图像。 这两种方法都可以提供，用户可以选择他们更熟悉的方法。
键盘支持
重要
键盘用户无法访问笔输入。 始终提供另一种输入形式。 例如，如果需要签名，请考虑为用户添加 文本输入 以输入其名称。 这两种方法都可以提供，用户可以选择他们更熟悉的方法。