拍摄照片或从本地设备加载图像。
Description
使用此控件，用户可以从其设备拍摄照片或上传图像文件，并使用此内容更新数据源。 在移动设备上，用户会显示设备选择对话框，以在拍摄照片或选择一个已可用照片之间进行选择。
此控件是包含两个控件的分组控件： “图像 ”和“ 添加图片”按钮。 如果尚未上传图像， 图像 控件将显示上传的图像或占位符。 “添加图片”按钮会提示上传图像。
请参阅图像属性的图像控件参考。
局限性
图片控件具有以下限制：
- 在 iOS 上使用 “添加图片 ”控件时，使用相机或库导入的图像不包含元数据，如方向、位置信息或相机设置。
添加图片按钮属性
AccessibleLabel – 屏幕阅读器标签。 应描述添加图片的目的。
对齐 - 文本相对于其控件的水平中心的位置。
BorderColor – 控件边框的颜色。
BorderStyle – 控件的边框是 Solid、 Dashed、 Dotted 还是 None。
BorderThickness – 控件边框的粗细。
ChangePictureText – 上传图像后按钮上显示的文本。
颜色 – 控件中的文本颜色。
DisabledBorderColor – 如果控件的 DisplayMode 属性设置为 Disabled，则控件边框的颜色。
DisabledColor – 控件中的文本颜色（如果控件的 DisplayMode 属性设置为 Disabled）。
DisabledFill – 控件的 DisplayMode 属性设置为 Disabled 时的背景色。
DisplayMode – 控件是否允许用户输入（编辑）、仅显示数据（视图）或已禁用（已禁用）。
错误 - 如果上传图像时遇到问题，此属性将包含适当的错误字符串。
填充 – 控件的背景色。
FocusedBorderColor – 当控件聚焦时控件边框的颜色。
FocusedBorderThickness – 当控件聚焦时控件边框的粗细。
字体 – 显示文本的字体系列的名称。
FontWeight – 控件中文本的粗细： 粗体、 半曲、 普通或 较轻。
高度 – 控件的上边缘和下边缘之间的距离。
HoverBorderColor – 当用户在该控件上保留鼠标指针时控件边框的颜色。
HoverColor – 当用户将鼠标指针放在控件上时，控件中文本的颜色。
HoverFill – 当用户将鼠标指针放在控件上时，控件的背景色。
斜体 – 控件中的文本是否为斜体。
媒体 – 音频或视频控件播放的剪辑的标识符。
OnChange – 当用户更改控件值时要执行的作（例如，通过调整滑块）。
OnSelect – 当用户点击或单击控件时要执行的作。
填充 – 导入或导出按钮上的文本与该按钮边缘之间的距离。
PressedBorderColor – 当用户点击或单击该控件时控件边框的颜色。
PressedColor – 当用户点击或单击该控件时控件中的文本颜色。
PressedFill – 当用户点击或单击该控件时控件的背景色。
重置 – 控件是否还原为其默认值。
大小 – 控件上显示的文本的字号。
删除线 – 是否通过控件上显示的文本显示线条。
TabIndex – 相对于其他控件的键盘导航顺序。
文本 – 图像尚未上传时按钮上显示的文本。
工具提示 – 当用户将鼠标悬停在控件上时出现的解释性文本。
下划线 – 是否在控件上显示的文本下显示一行。
UseMobileCamera – 是否直接使用手机摄像头（如果可用）。 将此设置为 TRUE 会强制用户使用相机拍摄照片，并禁用从设备库上传现有图像。
VerticalAlign – 控件上与该控件的垂直中心相关的文本位置。
可见 – 控件是显示还是隐藏。
宽度 – 控件的左边缘和右边缘之间的距离。
X – 控件左边缘与其父容器（如果没有父容器，则为屏幕）左边缘之间的距离。
Y – 控件上边缘与其父容器（如果没有父容器，则为屏幕）上边缘之间的距离。
相关函数
Patch（ DataSource、 BaseRecord、 ChangeRecord ）
例子
将图像添加到图像库控件
添加 “添加图片 ”控件，然后三次单击它。
不知道如何 添加、命名和配置控件？
在 “打开 ”对话框中，单击或点击图像文件，然后单击或点击“ 打开”。
添加按钮控件，将其移动到“添加图片”控件下，并将 Button 控件的 OnSelect 属性设置为以下公式：
Collect（MyPix、AddMediaButton1.Media）添加 垂直库 控件，并将其 Items 属性设置为 MyPix。
选择库中的图像控件，并将其设置为 Image 属性到 ThisItem.Value。
按 F5，然后单击或点击 按钮 控件。
“添加图片”控件中的图像显示在垂直库控件中。 如果图像的纵横比与垂直库控件中的图像控件不相同，请将图像控件的 ImagePosition 属性设置为“拟合”。
单击或点击 “添加图片 ”控件，单击或点击其他图像文件，单击或点击“ 打开”，然后单击或点击添加的 按钮 控件。
第二个图像显示在 图像库 控件中。
（可选）重复上一步或多次，然后按 Esc 返回到默认工作区。
使用 SaveData 函数在本地保存映像，或使用 Patch 函数更新数据源。
辅助功能指南
颜色对比度
- “添加图片”按钮 在其文本和背景之间必须具有足够的对比度。 由于上传的图像的颜色可能不同，请使用“添加图片”按钮上的不透明填充来确保一致的对比度。
屏幕阅读器支持
- “添加图片”按钮 必须具有 “文本 ”和 “ChangePictureText ”，提示用户添加或更改图片。
键盘支持
- 添加图片按钮 的 TabIndex 必须为零个或多个，以便键盘用户可以导航到它。
- “添加图片”按钮 必须具有清晰可见的焦点指示器。 使用 FocusedBorderColor 和 FocusedBorderThickness 来实现此目的。