ProgressBar コントロール
ProgressBar コントロールでは、進行状況メッセージを受信すると長さが変わる棒グラフが表示されます。 このコントロールでは、SetProgress ControlEvent がサブスクライブされます。 これは監視対象のアクションの名前が付いた ControlEvent をサブスクライブできます。
関連情報については、「ProgressBar コントロールの作成」と「ProgressBar へのカスタム アクションの追加」を参照してください。
コントロールの属性
このコントロールでは次の属性を使用できます。 イベントを使用して属性の値を変更するには、EventMapping テーブルの ControlEvent にコントロールをサブスクライブし、Attribute 列に属性の識別子を記載します。 Event 列に ControlEvent の識別子を入力します。
| 属性識別子 | 16 進数ビット | 説明 |
|---|---|---|
| Position | ダイアログ ボックス内のコントロールの位置。
Control テーブルの Width、Height、X、Y の各列に、コントロールの幅、高さ、左隅の座標を入力します。 長さと距離にはインストーラー単位を使用します。 |
|
| 進行状況 | この属性では、ProgressBar の塗りつぶし量が指定されます。 この属性は、2 つの整数と文字列で構成されています。 最初の整数フィールドは、現在の進行状況ティック数で、2 番目の整数フィールドは、既定の進行状況ティック数の最大数 (1024) です。 3 番目のフィールドは、進行中のアクションの名前である文字列です。 現在の進行状況ティック数が最大値を超える場合、インストーラーによって最大値に変更されます。 この属性は、SetProgress ControlEvent によって設定および変更されます。 Event 列に SetProgress を入力し、Attribute 列に Progress を入力して、EventMapping テーブルのこのイベントにコントロールをサブスクライブする必要があります。 |
|
| テキスト | コントロールによって表示されるテキスト。 テキスト文字列のフォントとフォント スタイルを設定するには、表示される文字の文字列の先頭に {\style} または {&style} を付けます。 ここで、style は、TextStyle テーブルの TextStyle 列に記載されている識別子です。 これらのどちらも存在しないが、DefaultUIFont プロパティが有効なテキスト スタイルとして定義されている場合は、そのフォントが使用されます。 |
|
| [表示] | 0x00000000 0x00000001 |
表示されないコントロール。 表示されるコントロール。 コントロールの作成時にコントロールを表示可能にするか非表示にするかを設定するには、Control テーブルの Attributes 列のビット ワードにこのビットを含めます。 ControlCondition テーブルを使って、コントロールの非表示または表示を設定することもできます。 |
| Sunken | 0x00000000 0x00000004 |
既定の表示スタイルを表示します。 浮き彫りの 3-D の外観を使用してコントロールを表示します。 Control テーブルの Attributes 列のビット ワードにこれらのビットを含めます。 |
| RTLRO | 0x00000000 0x00000020 |
コントロール内のテキストは、左から右への読み取り順序で表示されます。 コントロール内のテキストは、右から左への読み取り順序で表示されます。 |
| Progress95 | 0x00000000 0x00010000 |
連続バーとして描画された進行状況バー。 一連の四角形として描画された進行状況バー。 Control テーブルの Attributes 列のビット ワードにこれらのビットを含めます。 |
解説
このコントロールは、CreateWindowEx 関数を使用して、PROGRESS_CLASS クラスから作成できます。 これには、WS_CHILD および WS_GROUP のスタイルがあります。