コントロール (Windows インストーラー)

インストール パッケージの開発者は、このトピックで説明するコントロールを含んだユーザー インターフェイスを作成できます。 ダイアログ ボックスに特定のコントロールを追加する方法については、そのコントロールのトピックを参照し、「コントロールとテキストの追加」セクションをご覧ください。

CheckBox や ComboBox などの一部のコントロールは、Control テーブルの Property 列で指定されたプロパティに関連付けられます。 ユーザーは、コントロールを操作して、このプロパティの値を変更します。 ビルボードやビットマップなどのパッシブ コントロールは、このようなプロパティには関連付けされません。

セキュリティ上の理由から、プライベート プロパティは、ユーザーによるユーザー インターフェイスからの操作では変更できません。 ユーザー インターフェイスによって設定されるプロパティは、パブリック プロパティであり、大文字である必要があります。 「プロパティについて」も参照してください。

ダイアログから取り消すと、コントロールが正しく描画されない場合があります。 これは、[キャンセル] ダイアログが削除された後にコントロールが WM_PAINT メッセージを受信する順序に関係します。 この問題を解決するには、Control テーブルのコントロールの順序を変更してみてください。

コントロール名	関連付けられたプロパティ	コントロールの簡単な説明
Billboard	いいえ	進行状況メッセージに基づいてビルボードを表示します。
Bitmap	いいえ	ビットマップの静的な画像を表示します。
CheckBox	はい	2 つの状態のチェック ボックス。
ComboBox	はい	編集フィールドを含むドロップダウン リスト。
DirectoryCombo	Yes	パスの最後のセグメントを除くすべてを選択します。
DirectoryList	Yes	パスのメイン部分の下にフォルダーを表示します。
編集	はい	任意の文字列または整数の通常の編集フィールド。
GroupBox	いいえ	他のコントロールをグループ化する四角形を表示します。
ハイパーリンク	いいえ	既定のブラウザーで開くアドレスへの HTML リンクを表示します。Windows インストーラー 4.5 以前: サポートされていません。
アイコン	いいえ	アイコンの静的な画像を表示します。
線	いいえ	水平線を表示します。
ListBox	はい	編集フィールドを含まないドロップダウン リスト。
ListView	はい	選択用のアイコンを含む値の列を表示します。
MaskedEdit	はい	テキスト フィールドにマスクを含む編集フィールド。
PathEdit	はい	編集フィールドにフォルダー名またはパス全体を表示します。
ProgressBar コントロール	いいえ	進行状況メッセージを受信すると長さが変わる棒グラフ。
PushButton	いいえ	基本的なプッシュ ボタンを表示します。
RadioButtonGroup	はい	ラジオ ボタンのグループ。
ScrollableText	いいえ	テキストの長い文字列を表示します。
SelectionTree	はい	Feature テーブルの情報を表示し、ユーザーが選択状態を変更できるようにします。
テキスト	いいえ	静的テキストを表示します。
VolumeCostList	いいえ	さまざまなボリュームのコスト計算情報を表示します。
VolumeSelectCombo	はい	アルファベット順の一覧からボリュームを選択します。