Штрихкод — элемент управления сканера для приложений CanvasBarcode-scanner control for canvas apps

Проверяет штрихкоды, QR-коды и коды матриц данных на устройствах Android или iOS.Scans barcodes, QR codes, and data-matrix codes on an Android or iOS device. Не поддерживается в веб-браузере.Not supported in a web browser.

ОписаниеDescription

Элемент управления открывает собственный сканер на устройстве Android или iOS.The control opens a native scanner on an Android or iOS device. Средство проверки автоматически обнаруживает штрихкод, QR-код или код матрицы данных в представлении.The scanner automatically detects a barcode, a QR code, or a data-matrix code when in view. Элемент управления не поддерживает проверку в веб-браузере.The control doesn't support scanning in a web browser.

Основные свойстваKey properties

Value — выходное свойство, содержащее текстовое значение кода, который был проверен последним.Value – Output property that contains the text value of the code that was scanned most recently.

Type — выходное свойство, содержащее тип кода, который был проверен последним.Type – Output property that contains the type of the code that was scanned most recently.

Onscan — как приложение реагирует при успешном проходе сканирования штрихкода.OnScan – How an app responds when a barcode is successfully scanned.

OnCancel — как приложение реагирует, когда пользователь отменяет проверку штрихкода.OnCancel – How an app responds when a barcode scan is cancelled by the user.

Баркодетипе — тип штрихкода для проверки.BarcodeType - The barcode type to scan. Можно выбрать несколько типов штрихкодов, объединив их.You can target multiple barcode types by concatenating them. Символа.Ex. Баркодетипе. CODE128 & Баркодетипе. Code39 по умолчанию: AutoBarcodeType.Code128 & BarcodeType.Code39 Default: Auto

Преферфронткамера — используется ли фронтальная камера, если она доступна, для сканирования.PreferFrontCamera - Whether the front-facing camera, when available, is used for scanning.

Флашлигхтенаблед — указывает, включена ли фонарик автоматически при открытии сканера.FlashlightEnabled - Whether the flashlight is enabled automatically when the scanner is opened.

Дополнительные свойстваAdditional properties

Текст — текст, отображаемый на кнопке, которая активирует сканер.Text - Text that appears on the button that activates the scanner.

BorderColor  — цвет границы элемента управления.BorderColor – The color of a control's border.

BorderStyle  — стиль границы элемента управления: Сплошная, Штриховая, Пунктирная или Отсутствует.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness  — толщина границы элемента управления.BorderThickness – The thickness of a control's border.

DisplayMode — в зависимости от значения этого режима элемент управления разрешает пользователю вводить данные (Изменение), только отображает данные (Просмотр) или элемент вообще отключен (Отключено).DisplayMode – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

Высота — Высота кнопки, которая активирует сканер.Height – The height of the button that activates the scanner.

Tooltip — пояснительный текст, отображаемый при наведении указателя мыши на элемент управления.Tooltip – Explanatory text that appears when the user hovers over a control.

Type — тип кода, который был обнаружен при сканировании, которое было выполнено недавно.Type - The type of code that was detected in the scan that succeeded most recently.

Visible определяет, отображается ли элемент управления или он скрыт.Visible – Whether a control appears or is hidden.

Ширина — ширина кнопки, которая активирует сканер.Width – The width of the button that activates the scanner.

X  — расстояние между левым краем элемента управления и левым краем его родительского контейнера (или экрана, если родительского контейнера нет).X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

Y  — расстояние между верхним краем элемента управления и верхним краем его родительского контейнера (или экрана, если родительского контейнера нет).Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).

Руководство по настройке специальных возможностейAccessibility guidelines

Те же рекомендации для элемента управления "Кнопка" применяются к элементу управления сканера штрихкода , так как это кнопка, запускающая сканирование.The same guidelines for the Button control apply to the Barcode scanner control because it's a button that launches the scan.

Варианты визуального элементаVisual alternatives

  • Сканер штрихкодов — это кнопка, которая не отображает результат проверки.The barcode scanner is a button that doesn't display the scan result. Рассмотрите возможность отображения результатов проверки с помощью элемента управления Label .Consider showing the scan result with a Label control. Присвойте свойству Text метки значение свойства Value сканера штрихкода.Set the label's Text property to the barcode scanner's Value property. Присвойте свойству " Live " метки значение " вежливо ", чтобы пользователи Reader могли получать уведомления об изменениях.Set the label's Live property to Polite so that screen-reader users are notified of changes. Это изменение делает отсканированное значение доступным для всех, независимо от визуальных возможностей.This change makes the scanned value accessible to everyone, regardless of visual ability.

  • Пользователи, имеющие ограниченный визуальный элемент и двигатель, могут предпочесть не указывать камеру на штрихкоде.Users who have visual and motor disabilities might prefer not to point the camera at a barcode. Рекомендуется добавить другую форму ввода, например элемент управления для ввода текста , чтобы пользователи могли вводить штрихкоды.Consider adding another form of input, such as a Text input control, for users to enter barcodes.

Доступность штрихкодов по устройствамBarcode Availability by Device

Тип штрихкодаBarcode Type AndroidAndroid iOSiOS
QR_CODEQR_CODE
DATA_MATRIXDATA_MATRIX
UPC_AUPC_A
UPC_EUPC_E
EAN_8EAN_8
EAN_13EAN_13
CODE_39CODE_39
CODE_93CODE_93
CODE_128CODE_128
кодабарCODABAR
итфITF
RSS14RSS14
PDF_417PDF_417
RSS_EXPANDEDRSS_EXPANDED
MSIMSI
азтекAZTEC

Примечание. PDF_417 и АЗТЕК не поддерживаются в режиме AutoNOTE: PDF_417 and AZTEC are not supported in Auto mode