Android、iOS、および Windows デバイス上のバーコード、QR コード、およびデータ マトリックス コードをスキャンします。
Description
このコントロールは、Android、iOS、および Windows デバイスでネイティブ スキャナーを開きます。 iOS および Android では、スキャナーは次のスキャン モードをサポートしています。
- 自動スキャン – バーコードが検出されるとすぐにスキャンされます。
- スキャンを選択する – ユーザーは、スキャンする検出されたバーコードを決定できます。 コントロールは、Web ブラウザーでのスキャンをサポートしていません。
- 複数スキャン – ユーザーはバーコードセッション中に複数のバーコードをスキャンできます。
Windows デバイスでは、バーコード リーダーは常 に自動的にスキャンされます。
バーコードリーダーコントロールは、さまざまなズームレベルをサポートし、スキャンエクスペリエンス内からデバイスの懐中電灯をオン/オフします。
注
バーコード スキャナー コントロールは、Android、iOS、および Windows デバイスでサポートされています。 他のすべてのプラットフォームでは、アプリの一部の機能が機能しないことを示す警告が表示されます。
重要なプロパティ
バーコード – 2 つの列でスキャンされたバーコードのテーブルを含む Output プロパティ: Value と Type。 値 はスキャンされたコードのテキスト値で、 Type はスキャンされたコードの種類です。
OnScan – バーコードが正常にスキャンされたときに実行するアクション。
OnCancel – バーコード スキャンがユーザーによってキャンセルされたときに実行するアクション。
OnChange - バーコード リーダー コントロールのプロパティが変更されたときに実行するアクション (出力プロパティを含む)。
BarcodeType - スキャンするバーコードの種類。 複数のバーコードの種類を連結することで、対象を絞ることができます。 例:
'Microsoft.BarcodeReader.BarcodeType'.Code128 & 'Microsoft.BarcodeReader.BarcodeType'.Code39。
既定値: 自動
スキャン モード - ビューで検出された最初のバーコードをAutomatically scanするか、ビュー内のどのバーコードをスキャンするか、または 1 回のセッションでバーコードをScan multipleするかをユーザーがSelect to scanできるようにします。 Windows では、バーコード リーダーは常に Automatically scan。
スキャン品質 - バーコード リーダーがスキャンする画像品質。 小さなバーコードには高品質が適していますが、パフォーマンスが低下する可能性があります。 Windows では、バーコード リーダーは常にデバイスのカメラ品質でスキャンします。 既定値: 自動。
PreferFrontCamera - 有効にすると、バーコード リーダーは、背面カメラではなく前面カメラを使用するように既定で設定されます。
BeepOnScan - 有効にすると、バーコードリーダーはバーコードのスキャン時にビープ音を鳴らします。
VibrateOnScan - 有効にすると、バーコードがスキャンされたときにバーコード リーダーが振動します。
追加のプロパティ
テキスト - スキャナーをアクティブにするボタンに表示されるテキスト。
BorderColor – コントロールの境界線の色。
BorderStyle – コントロールの境界線が Solid、Dashed、Doted、None のいずれであるか。
BorderThickness – コントロールの境界線の太さ。
DisplayMode – コントロールでユーザー入力 (編集) を許可するか、データのみを表示するか (表示)、無効 (無効) にするかを指定します。
高さ – スキャナーをアクティブにするボタンの高さ。
ヒント – ユーザーがコントロールの上にマウス ポインターを置いたときに表示される説明テキスト。
表示 – コントロールが表示されるか非表示になっているか。
Width – スキャナーをアクティブにするボタンの幅。
X – コントロールの左端とその親コンテナーの左端との間の距離 (親コンテナーがない場合は画面)。
Y – コントロールの上端と親コンテナーの上端との間の距離 (親コンテナーがない場合は画面)。
アクセシビリティ ガイドライン
Button コントロールはスキャンを起動する ボタン であるため、 バーコード リーダー コントロールにも同じガイドラインが適用されます。
視覚的な代替手段
バーコード スキャナーは、スキャン結果を表示しないボタンです。 ラベル コントロールを使用してスキャン結果を表示することを検討してください。 ラベルの Text プロパティを、バーコード リーダー コントロールの名前
BarcodeReaderFirst(BarcodeReader.Barcodes).Valueに設定します。 ラベルの Live プロパティを [通知] に設定して、スクリーン リーダー ユーザーに変更の通知を受け取るようにします。 この変更により、ビジュアル機能に関係なく、スキャンされた値にすべてのユーザーがアクセスできるようになります。視覚障碍や運動障碍のあるユーザーは、カメラをバーコードに向けないことを好む場合があります。 ユーザーがバーコードを入力できるように、 テキスト入力 コントロールなどの別の形式の入力を追加することを検討してください。
デバイス別のバーコードの可用性
| バーコードの種類 | iOS および Android でサポートされています | Windows でサポートされています | 注記 |
|---|---|---|---|
| QR_CODE | ✔ | ✔ | |
| DATA_MATRIX | ✔ | ✖ | |
| アステカ | ✔ | ✖ | |
| CODABAR | ✔ | ✔ | |
| CODE_128 | ✔ | ✔ | |
| CODE_39 | ✔ | ✔ | |
| CODE_93 | ✔ | ✖ | |
| EAN | ✔ | ✔ | EAN_8とEAN_13をサポート |
| インターリーブ 2/5 ITF |
✔ | ✖ | |
| PDF_417 | ✔ | ✖ | |
| RSS14 Databar 14 |
✔ | ✖ | Android および iOS でのスタックおよび全方向のサポート |
| RSS_EXPANDED Databar Expanded |
✔ | ✖ | Android および iOS でのスタックおよび全方向のサポート |
| UPC | ✔ | ✔ | UPC_AとUPC_Eをサポート |
| マイクロ QR コード | ✔ | ✖ | |
| GS1-DWCode | ✖ | ✖ | |
| MSI | ✖ | ✖ |
Select() バーコード リーダー コントロール
バーコード リーダー コントロールは Select() をサポートしていません。 回避策として、バーコード リーダーの塗りつぶしの色を透明に設定し、バーコード リーダーを選択するコントロールの前に配置します。 これにより、アプリ ユーザーがコントロールを選択すると、実際のコントロールではなく非表示のバーコード リーダー ボタンが選択されるため、バーコード リーダー エクスペリエンスが起動する場合と同じエクスペリエンスになります。