QR
QRウィジェットは、指定した文字列をQRコード画像に変換して画面に表示するウィジェットです。
URL・テキストなどをQRコードにして見せるときに使用し、中央にロゴ画像を入れられます。
定義・役割
QRウィジェットは、valueに入れた文字列をQRコードにエンコードし、正方形の画像として描画します。背景色とサイズを設定でき、中央にロゴ画像を重ねて表示できます。
- カテゴリー: Contents
- デフォルトの背景色:
#FFFFFF（白） — QRモジュールと目（コーナーの四角）の色は黒で固定 - 常に正方形で表示（幅・高さのうち小さい値を一辺として使用）
機能
| 機能 | 説明 |
|---|---|
| QRコードの生成 | valueに入れた文字列をQRコードに変換してレンダリングします。値が空の場合は自動的にLucy Studioが表示されます。 |
| 中央ロゴ | imageに画像を指定すると、QRコードの中央にロゴを重ねて表示します。logoRatioでロゴのサイズを調整します。 |
| 背景色 | colorでQRコードの背景色を指定します（デフォルトは白）。モジュール・目の色は黒で固定されます。 |
| サイズ（正方形） | width・heightのうち小さい値を一辺として使用し、常に正方形で描画します。 |
使い方
- 左のウィジェットパレットでContentsカテゴリーを開きます。
- QR項目をキャンバスにドラッグ＆ドロップします。
- 右のPropertiesパネルで、
valueにQRコードにする文字列（URL・テキストなど）を入力します。 - 必要に応じて
imageに中央ロゴ画像を指定し、logoRatioでサイズを調整します。 - 必要に応じて背景色（
color）・サイズ（Size）を調整します。
プロパティ
| プロパティ | 説明 | デフォルト値 | 値 / タイプ |
|---|---|---|---|
value | QRコードにエンコードする文字列。空の場合はLucy Studioに置き換えられます。 | 空文字列 | 文字列 |
image | QRコードの中央に重ねて表示するロゴ画像（任意） | なし | 画像 |
placeholder | 値が空のときに表示する代替テキスト — 現在のバージョンでは動作しません。 | 未指定 | 文字列 |
Size | ウィジェットのサイズ — 幅・高さ。未指定の場合は配置領域または200を使用します。QRコードは小さい方の値を一辺として正方形で表示します（展開するとwidth・height） | 未指定 | 数値（px） |
color | QRコードの背景色（モジュール・目の色は黒で固定） | #FFFFFF（白） | カラー |
colorBlendMode | カラーブレンドモード — 現在のバージョンでは動作しません。 | 未指定 | ブレンドモード |
fit | 画像のフィット方式 — 現在のバージョンでは動作しません。 | 未指定 | fill / contain / cover / fitWidth / fitHeight / none / scaleDown |
alignment | アライメント — 現在のバージョンでは動作しません。 | center | アライメント |
repeat | 繰り返し方式 — 現在のバージョンでは動作しません。 | noRepeat | repeat / repeatX / repeatY / noRepeat |
centerSlice | センタースライス領域 — 現在のバージョンでは動作しません。 | 未指定 | 矩形領域 |
matchTextDirection | テキスト方向の一致 — 現在のバージョンでは動作しません。 | オフ（false） | 真 / 偽 |
gaplessPlayback | ギャップレス再生 — 現在のバージョンでは動作しません。 | オフ（false） | 真 / 偽 |
isAntiAlias | アンチエイリアス — 現在のバージョンでは動作しません。 | オフ（false） | 真 / 偽 |
filterQuality | フィルター品質 — 現在のバージョンでは動作しません。 | low | none / low / medium / high |
semanticLabel | セマンティックラベル — 現在のバージョンでは動作しません。 | 未指定 | 文字列 |
excludeFromSemantics | セマンティクスからの除外 — 現在のバージョンでは動作しません。 | オフ（false） | 真 / 偽 |
logoRatio | 一辺に対する中央ロゴのサイズ比率。0〜0.5の範囲に制限されます。 | 0.28 | 数値（0〜0.5） |
注記
上の表で「現在のバージョンでは動作しません」と記載した画像系のプロパティ（fit・repeat・alignment・filterQualityなど）は、あわせて登録されていますがQRコードのレンダリングには影響しません。
注意・ヒント
警告
valueが空の場合、QRコードには自動的にLucy Studioがエンコードされます。必要な値を必ず入力してください。
ヒント
中央にロゴを入れると、ロゴで覆われた部分を補正するためエラー訂正レベルが自動的に上がります（ロゴなしはM、ロゴありはQ）。logoRatioは0〜0.5に制限され、デフォルト値は0.28です。
さらに詳しく
ヒント
このウィジェットをスクリプトで制御するWidget Control（Property・Method・Event）の全体は、QR Widget Controlドキュメントで確認してください。