Power Apps 中的 条码读取器 控件

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

说明

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

• 自动扫描 – 一检测到条码就会立即扫描。
• 选择扫描 – 用户可以确定要扫描哪些检测到的条码。 此控件不支持在 Web 浏览器中进行扫描。
• 扫描多个 - 用户可以在条形码会话过程中扫描多个条形码。

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

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

备注

条码扫描仪 控件在 Android、iOS 和 Windows 设备上受支持。 所有其他平台将显示警告，提示应用的某些功能无法使用。

键属性

Barcodes – 包含两列的扫描条码的表的输出属性：值和类型。 值是扫描的条码的文本值，类型是扫描的条码的类型。

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

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

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

BarcodeType - 要扫描的条码类型。 您可以通过连接来指定多个条码类型。 例如 'Microsoft.BarcodeReader.BarcodeType'.Code128 & 'Microsoft.BarcodeReader.BarcodeType'.Code39。 默认值：Auto

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

扫描质量 - 条形码读取器扫描所按照的图像质量。 较高质量适用于小条形码，但可能会导致性能下降。 在 Windows 上，条形码读取器将始终以设备相机质量进行扫描。 默认：自动。

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

BeepOnScan - 如果启用，条码读取器将在扫描条形码时发出蜂鸣声。

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

其他属性

Text - 在用于激活扫描仪的按钮上显示的文本。

BorderColor – 控件边框的颜色。

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

BorderThickness – 控件边框的粗细。

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

Height – 激活扫描仪的按钮的高度。

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

Visible – 控件显示还是隐藏。

Width – 激活扫描仪的按钮的宽度。

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

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

辅助功能准则

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

视觉对象替代

• 条码扫描仪是不显示扫描结果的按钮。 请考虑使用 标签 控件显示扫描结果。 将标签的 Text 属性设置为 First(BarcodeReader.Barcodes).Value，其中 BarcodeReader 是 条码读取器 控件的名称。 将标签的 Live 属性设置为 Polite 以通知屏幕阅读器用户发生更改。 此更改使扫描值对每个人都可用，无论其视觉能力如何。

• 有视觉和运动障碍的用户可能更希望不需要将相机对准条码。 请考虑添加另一种形式的输入，如 文本输入 控件，供用户输入条码。

设备的条码可用性

条形码类型	iOS 和 Android 上支持	Windows 中支持	注释
QR_CODE	✔	✔
DATA_MATRIX	✔	✖
AZTEC	✔	✖
CODABAR	✔	✔
CODE_128	✔	✔
CODE_39	✔	✔
CODE_93	✔	✖
EAN	✔	✔	支持 EAN_8 和 EAN_13
Interleaved 2 of 5 ITF	✔	✖
PDF_417	✔	✖
RSS14 Databar 14	✔	✖	Android 和 iOS 支持堆积和全向
RSS_EXPANDED Databar Expanded	✔	✖	Android 和 iOS 支持堆积和全向
UPC	✔	✔	支持 UPC_A 和 UPC_E
Micro QR 码	✔	✖
GS1-DWCode	✖	✖
MSI	✖	✖

Select() 条码读取器 控件

条码读取器 控件不支持 Select()。 作为一种解决方法，请将条形码读取器填充颜色设置为透明，并将其放在您想要用来选择条形码读取器的控件前面。 这将为应用用户带来相同的体验，选择控件会启动条形码读取器体验，因为他们将选择不可见的条形码读取器按钮而不是实际控件。

另请参见

Power Apps 中的控件限制

备注

您能告诉我们您的文档语言首选项吗？ 进行简短调查。（请注意，此调查是英文版调查）

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