Checkbox
Checkboxウィジェットは、オン/オフの2つの状態を切り替える選択ウィジェットです。利用規約への同意や複数項目の多重選択などに使用します。
備考
サンプルファイル: 07_Work_with_Widgets/checkbox_objet.lfp
定義・役割
Checkboxウィジェットは四角いチェック領域を描画し、押すとチェック/解除がアニメーションとともに切り替わります。状態が変わるとonChangedの動作が実行されます。サイズ・色・枠線を設定できます。
- カテゴリー: Contents（入力・選択）
- デフォルトの状態: オフ（未チェック）
機能
| 機能 | 説明 |
|---|---|
| 2状態のトグル | 押すとチェック/解除が切り替わります（切り替えアニメーション付き）。 |
| 状態変更の検知 | 状態が変わるときにonChangedが実行され、変わった値を渡します。 |
| 見た目の設定 | サイズ・枠線・チェック時/未チェック時の背景色・チェックマークの色を調整します。 |
使い方
- 左のウィジェットパレットでContentsカテゴリーを開きます。
- Checkbox項目をキャンバスにドラッグ＆ドロップします。
- Propertiesパネルで初期状態（
value）とサイズ・色を設定します。 onChangedに、状態が変わったときに実行する動作を接続します。
プロパティ
| プロパティ | 説明 | デフォルト値 | 値 / タイプ |
|---|---|---|---|
value | チェックの有無（初期状態） | オフ（false） | 真 / 偽 |
size | チェックボックスのサイズ | 30 | 数値（px） |
borderColor | 枠線の色 | #666666 | カラー |
borderWidth | 枠線の太さ | 1 | 数値（0以上） |
borderRadius | 角の角丸 | 0 | 数値 |
activeColor | チェック時の背景色 | #00AAFF | カラー |
inactiveColor | 未チェック時の背景色 | #FFFFFF | カラー |
checkColor | チェックマーク（✔）の色 | #FF0000 | カラー |
unCheckColor | 未チェック表示の色 | 透明 | カラー |
注意・ヒント
ヒント
onChangedに接続した動作は、変わったあとの状態値（真/偽）を受け取ります。
ヒント
チェック時の見た目はactiveColor（背景）とcheckColor（✔マーク）で合わせて調整します。
さらに詳しく
ヒント
このウィジェットをスクリプトで制御するWidget Control（Property・Method・Event）の全体は、Checkbox Widget Controlドキュメントで確認してください。