Button

Buttonウィジェットは、ユーザーが押すと指定した動作を実行するクリック可能なボタンです。
確認・キャンセル・画面移動など、画面のあらゆるアクショントリガーに使います。

備考

サンプルファイル: 07_Work_with_Widgets/button_objet.lfp

定義・役割

Buttonウィジェットは、テキスト（および任意のアイコン）を含む押せるエリアを描画します。押すとonClickに接続した動作が実行されます。背景色・枠線・角丸・サイズ・アイコンの位置を設定できます。

機能	説明
クリック時の動作	ボタンを押すと`onClick`に接続した動作（ロジック・スクリプト）が実行されます。
テキスト・背景	表示文字と背景色を設定します。テキストはデータバインディングに対応します。
アイコンの表示	文字と一緒にアイコンを配置し、位置（上・左・右・下）を指定します。
見た目の設定	サイズ・アライメント・余白・枠線・角丸を調整します。

注記

文字のカラーやサイズなど詳細な文字スタイルは、共通のStyle設定で指定します。以下はButton固有のプロパティです。

プロパティ	説明	デフォルト値	値 / タイプ
`Size`	ボタンのサイズ - 幅（width）・高さ（height）をまとめて指定するグループプロパティ	幅`100`・高さ`50`	サイズ（幅・高さ、px単位の数値）
`alignment`	ボタン内のコンテンツのアライメント	中央	アライメント値
`padding`	ボタンの内側の余白	`0`	余白値
`border`	枠線	白1px	枠線値
`radius`	角丸	未設定	角丸値
`fillColor`	ボタンの背景色	`#009DFF`（ブルー）	カラー
`text`	ボタンに表示する文字列（データバインディング対応）	`Button`	文字列
`textStyle`	文字スタイル（カラー・サイズ・太さなど）	未設定	テキストスタイル
`iconPadding`	アイコンの余白	`0`	余白値
`iconDirection`	文字を基準としたアイコンの位置	`left`	`top`, `left`, `right`, `bottom`
`icon`	ボタンに入れるアイコン（任意）	なし	アイコン設定

注記

ボタンが実際に反応するには、onClickに実行する動作を接続する必要があります。接続された動作がない場合、ボタンをクリックしても何も起こりません。

ヒント

文字のカラーやサイズはtextStyle（共通のStyle）で設定します。アイコンをオンにすると、iconDirectionで文字に対する位置を変更できます。

ヒント

このウィジェットをスクリプトで制御するWidget Control（Property・Method・Event）の全体は、Button Widget Controlドキュメントで確認してください。