画布应用中的添加图片控件

拍摄照片或加载本地设备中的图像。

描述

借助此控件,用户可以拍摄照片或者上传自己设备中的图像文件,并使用此内容更新数据源。 在移动设备上,用户将看到设备的选择对话框,以供在拍摄照片或选择已有照片之间进行选择。

此控件是包含两个控件的分组控件:图像添加图片按钮。 如果不上传任何图像,图像控件将显示已上传的图像或占位符。 添加图片按钮提示要上传的图像。

有关Image属性,请参阅图像控件引用

限制

图片控件具有以下限制:

  • 当在 iOS 上使用添加图片控件时,使用相机或库导入的图像不包含元数据、例如方向、位置信息或相机设置。

添加图片 按钮属性

AccessibleLabel – 屏幕阅读器标签。 应描述添加图片的用途。

Align – 文本相对于其控件的水平居中的位置。

BorderColor – 控件边框的颜色。

BorderStyle – 控件边框是 SolidDashedDotted 还是 None

BorderThickness – 控件边框的粗细。

ChangePictureText – 上传图像时按钮上显示的文本。

Color – 控件中文本的颜色。

DisabledBorderColor – 控件的 DisplayMode 属性设置为 Disabled 时,该控件边框的颜色。

DisabledColor – 控件的 DisplayMode 属性设置为 Disabled 时,该控件中的文本颜色。

DisabledFill – 控件的 DisplayMode 属性设置为 Disabled 时,该控件的背景色。

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

Error - 如果在上传图像时出现问题,该属性将包含相应的错误字符串。

Fill – 控件的背景色。

FocusedBorderColor – 当聚焦到控件时,控件的边框颜色。

FocusedBorderThickness – 当聚焦到控件时,控件的边框粗细。

Font – 文本中所显示的字体系列的名称。

FontWeight – 控件中文本的粗细:BoldSemiboldNormalLighter

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

HoverBorderColor – 用户将鼠标指针停留在控件上时,该控件边框的颜色。

HoverColor – 用户将鼠标指针停留在控件上时,该控件中的文本颜色。

HoverFill – 用户将鼠标指针停留在控件上时,该控件的背景色。

Italic – 控件中的文本是否为斜体。

Media – 音频或视频控件播放的剪辑的标识符。

OnChange - 用户更改控件的值(例如,通过调整滑块)时要执行的操作。

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

Padding – 导入或导出按钮上的文本和该按钮边缘之间的距离。

PressedBorderColor – 用户在点击或单击控件时,该控件边框的颜色。

PressedColor – 用户在点击或单击控件时,该控件中的文本的颜色。

PressedFill – 用户在点击或单击控件时,该控件的背景色。

Reset – 控件是否还原为其默认值。

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

Strikethrough – 通过文本显示的线是否在控件上显示。

TabIndex – 相对于其他控件的键盘导航顺序。

Text – 未上传图像时按钮上显示的文本。

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

Underline – 在文本下方显示的线是否在控件上显示。

UseMobileCamera – 是否可以直接使用移动相机(如果可用)。 对于 Android 设备,此属性需要启用试验性设置改进的媒体捕获

VerticalAlign – 控件上的文本相对于该控件垂直居中的位置。

Visible – 控件显示还是隐藏。

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

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

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

Patch( DataSource, BaseRecord, ChangeRecord )

示例

  1. 添加添加图片控件,然后三击该控件。

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

  2. 打开对话框中,单击或点击图像文件,然后单击或点击打开

  3. 添加 按钮 控件,将其移到 添加图片 控件下方,然后将 按钮 控件的 OnSelect 属性设置为以下公式:
    Collect(MyPix, AddMediaButton1.Media)

    想要了解有关 Collect 函数或其他函数的详细信息?

  4. 添加 Vertical gallery 控件,并将其 Items 属性设置为 MyPix

  5. 在图库中选择 图像 控件,并将其 Image 属性设置为 ThisItem.Value

  6. 按 F5,然后单击或点击 按钮 控件。

    来自添加图片控件的图像将显示在 Vertical gallery 控件中。 如果图像和 Vertical gallery 控件中的 图像 控件纵横比不相同,请将 图像 控件的 ImagePosition 属性设置为适应

  7. 单击或点击添加图片控件,单击或点击另一个图像文件,单击或点击打开,然后单击或点击所添加的 按钮 控件。

    第二个图像将显示在 图像库 控件中。

  8. (可选)重复上述步骤一次或多次,然后按 Ecs 返回默认工作区。

使用 SaveData 函数本地保存图像或使用 Patch 函数更新数据源。

辅助功能准则

适用 按钮图像 的相同准则。 此外,请考虑以下方面:

颜色对比度

  • 添加图片按钮必须在其文本和背景之间有足够的对比度。 由于已上传的图像可能具有不同的颜色,请在添加图片按钮上使用不透明的 Fill 以确保一致对比度。

屏幕阅读器支持

  • 添加图片按钮必须具有 TextChangePictureText,提示用户添加或更改图片。

键盘支持

  • 添加图片按钮必须具有为零或更大的 TabIndex,以便键盘用户可以导航到它。
  • 添加图片按钮必须具有清晰可见的焦点指示器。 可以使用 FocusedBorderColorFocusedBorderThickness 来实现此目的。

备注

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

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