Power Apps 中的条形码阅读器控件

扫描 Android、iOS 和 Windows 设备上的条形码、QR 码和数据矩阵代码。

Description

该控件在 Android、iOS 和 Windows 设备上打开本机扫描程序。 在 iOS 和 Android 上，扫描程序支持以下扫描模式：

• 自动扫描 – 检测到条形码后立即扫描。
• 选择扫描 – 用户可以确定要扫描的检测到的条形码。 控件不支持在 Web 浏览器中扫描。
• 扫描多个 – 用户可以在条形码会话期间扫描多个条形码。

在 Windows 设备上，条形码阅读器将始终 自动扫描。

条形码阅读器控件支持不同的缩放级别，并在扫描体验中打开/关闭设备的手电筒。

键属性

Barcodes – Output 属性，其中包含用两列扫描的条形码表： 值和 类型。 值 是扫描的代码的文本值，而 Type 是扫描的代码的类型。

OnScan – 成功扫描条形码时要执行的作。

OnCancel – 当用户取消条形码扫描时要执行的作。

OnChange - 更改条形码读取器控件上的属性时要执行的作，包括输出属性。

BarcodeType - 要扫描的条形码类型。 可以通过连接多个条形码类型来定位这些条形码类型。 例如 'Microsoft.BarcodeReader.BarcodeType'.Code128 & 'Microsoft.BarcodeReader.BarcodeType'.Code39。 默认值：自动

扫描模式 - 无论是 Automatically scan 在视图中检测到的第一个条形码，还是允许用户 Select to scan 在单个会话中扫描哪些条形码或 Scan multiple 条形码。 在 Windows 上，条形码阅读器将始终 Automatically scan。

扫描质量 - 条形码阅读器扫描的图像质量。 质量较高的小条形码是好的，但可能导致性能缓慢。 在 Windows 上，条形码阅读器将始终扫描设备的相机质量。 默认值：自动。

PreferFrontCamera - 如果启用，条形码阅读器将默认使用前置摄像头，而不是后置摄像头。

BeepOnScan - 如果启用，条形码阅读器将在扫描条形码时播放蜂鸣声。

振动OnScan - 如果启用，条形码阅读器将在扫描条形码时振动。

其他属性

文本 - 在激活扫描程序的按钮上显示的文本。

BorderColor – 控件边框的颜色。

BorderStyle – 控件的边框是 Solid、 Dashed、 Dotted 还是 None。

BorderThickness – 控件边框的粗细。

DisplayMode – 控件是否允许用户输入（编辑）、仅显示数据（视图）或已禁用（已禁用）。

高度 – 激活扫描程序的按钮的高度。

工具提示 – 当用户将鼠标悬停在控件上时出现的解释性文本。

可见 – 控件是显示还是隐藏。

宽度 – 激活扫描程序的按钮的宽度。

X – 控件的左边缘与其父容器的左边缘之间的距离（屏幕（如果没有父容器）。

Y – 控件的上边缘与父容器的上边缘之间的距离（屏幕（如果没有父容器）。

辅助功能指南

按钮控件的相同准则适用于条形码阅读器控件，因为它是启动扫描的按钮。

视觉替代项

• 条形码扫描仪是一个不显示扫描结果的按钮。 请考虑使用 标签 控件显示扫描结果。 将标签的 Text 属性设置为First(BarcodeReader.Barcodes).ValueBarcodeReader条形码阅读器控件的名称。 将标签的 Live 属性设置为 “礼貌 ”，以便屏幕阅读器用户收到更改通知。 此更改使扫描的值可供所有人访问，而不管视觉能力如何。

• 具有视觉和运动障碍的用户可能不想将相机指向条形码。 请考虑添加另一种输入形式，例如 文本输入 控件，以便用户输入条形码。

按设备提供的条形码可用性

Select（） 条形码阅读器控件

条形码阅读器控件不支持 Select（）。 解决方法是，将条形码阅读器填充颜色设置为透明，并将其置于要选择条形码阅读器的控件前面。 这将导致应用用户的体验相同，其中选择控件会启动条形码阅读器体验，因为它们将选择不可见的条形码阅读器按钮而不是实际控件。

另请参阅

Power Apps 中控件的限制