PushButton コントロール

  • [アーティクル]

PushButton コントロールには、基本的なプッシュ ボタン (コマンド ボタンとも呼ばれます) が表示されます。

PushButton コントロールを使用して、IgnoreChange ControlEvent、SelectionDescription ControlEvent、SelectionSize ControlEvent、SelectionPath ControlEvent、SelectionPathOn ControlEvent、SelectionAction ControlEvent、SelectionNoItems ControlEvent、ActionText ControlEvent、ActionData ControlEvent、SetProgress ControlEvent、または TimeRemaining ControlEvent を発行することはできません。

このコントロールでは次の属性を使用できます。 イベントを使用して属性の値を変更するには、EventMapping テーブルの ControlEvent にコントロールをサブスクライブし、Attribute 列に属性の識別子を記載します。 Event 列に ControlEvent の識別子を入力します。

属性識別子 16 進数ビット 説明
Position ダイアログ ボックス内のコントロールの位置。 Control テーブルの Width、Height、X、Y の各列に、コントロールの幅、高さ、左隅の座標を入力します。 長さと距離にはインストーラー単位を使用します。
テキスト このコントロール属性は、コントロールによって表示されるテキスト、Binary テーブルに格納されている画像、または実行時に設定された画像を指定できます。 テキストを指定するには、Control テーブルの Text 列にテキスト文字列を入力します。 テキスト文字列のフォントとフォント スタイルを設定するには、表示される文字の文字列の先頭に {\style} または {&style} を付けます。 ここで、style は、TextStyle テーブルの TextStyle 列に記載されている識別子です。 これらのどちらも存在しないが、DefaultUIFont プロパティが有効なテキスト スタイルとして定義されている場合は、そのフォントが使用されます。
Binary テーブルに格納されているアイコンまたはビットマップ画像を指定するには、Binary テーブルの Name 列から、コントロールに対する Control テーブル レコードの Text 列に、画像のレコードの主キーを入力します。
[表示] 0x00000000 0x00000001
 表示されないコントロール。 表示されるコントロール。
コントロールの作成時にコントロールを表示可能にするか非表示にするかを設定するには、Control テーブルの Attributes 列のビット ワードにこのビットを含めます。
ControlCondition テーブルを使って、コントロールの非表示または表示を設定することもできます。
有効 0x00000000 0x00000002
 無効状態のコントロール。 有効状態のコントロール。
作成時にコントロールを有効にするには、Control の Attributes 列にこのビットを含めます。
ControlCondition テーブルを使用して、コントロールを有効または無効にすることもできます。
Sunken 0x00000000 0x00000004
 既定の表示スタイルを表示します。 浮き彫りの 3-D の外観を使用してコントロールを表示します。
Control テーブルの Attributes 列のビット ワードにこれらのビットを含めます。
RTLRO 0x00000000 0x00000020
 コントロール内のテキストは、左から右への読み取り順序で表示されます。 コントロール内のテキストは、右から左への読み取り順序で表示されます。
Bitmap 0x00000000 0x00040000
 コントロールのテキストは Control テーブルの Text 列に指定されます。 ボタンは BS_BITMAP スタイルで、コントロール内のテキストはビットマップ画像に置き換えられます。 Control テーブルの Text 列は、Binary テーブルへの外部キーとして使用されます。
Controlの Attributes 列のビット ワードにこのビットを含めます。
アイコンとビットマップ スタイルのビットを同時に設定しないでください。 ボタンにビットマップ画像とテキストの両方を含めることはできません。
テキスト文字列のフォントとフォント スタイルを設定するには、表示される文字の文字列の先頭に {\style} または {&style} を付けます。 ここで、style は、TextStyle テーブルの TextStyle 列に記載されている識別子です。 これらのどちらも存在しないが、DefaultUIFont プロパティが有効なテキスト スタイルとして定義されている場合は、そのフォントが使用されます。
Icon コントロール 0x00000000 0x00080000
 コントロールのテキストは Control テーブルの Text 列に指定されます。 ボタンは BS_ICON スタイルで、コントロール内のテキストはアイコン画像に置き換えられます。 Control テーブルの Text 列は、Binary テーブルへの外部キーとして使用されます。
Controlの Attributes 列のビット ワードにこのビットを含めます。
アイコンとビットマップのビットを同時に設定しないでください。 ボタンにアイコン画像とテキストの両方を含めることはできません。
テキスト文字列のフォントとフォント スタイルを設定するには、表示される文字の文字列の先頭に {\style} または {&style} を付けます。 ここで、style は、TextStyle テーブルの TextStyle 列に記載されている識別子です。 これらのどちらも存在しないが、DefaultUIFont プロパティが有効なテキスト スタイルとして定義されている場合は、そのフォントが使用されます。
FixedSize 0x00000000 0x00100000
 コントロールに合わせてアイコン画像を拡大します。 コントロール内のアイコン画像をトリミングするか、中央に表示します。
BBControl テーブルまたは Control テーブルの Attributes 列のビット ワードにこのビットを含めます。
IconSize 0x00000000 0x00200000
0x00400000
0x00600000
 最初の画像を読み込みます。 最初の 16 x 16 画像を読み込みます。
最初の 32 x 32 画像を読み込みます。
最初の 48 x 48 画像を読み込みます。
アイコン ファイルには、同じアイコンのさまざまなサイズの画像を含めることができます。 Control テーブルの Attributes 列に適切なビット ワードの値を含めます
これらのビットが設定されていない場合、インストーラーで FixedSize 属性は無視され、画像はコントロールの四角形に合わせて拡大されます。 IconSize ビットと FixedSize ビットの両方が設定されている場合、コントロールよりも小さい画像は中央に配置され、コントロールよりも大きい画像は収まるように縮小されます。
ElevationShield 0x00000000 0x00800000
 PushButton の外観は、他のアイコン属性によって決まります。 ユーザー アカウント制御 (UAC) 昇格アイコン (シールド アイコン) を PushButton コントロールに追加します。

 

解説

このコントロールは、CreateWindowEx 関数を使って、BUTTON クラスから作成できます。 これには、BS_MULTILINE、WS_CHILD、WS_TABSTOP、WS_GROUP のスタイルがあります。