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 のスタイルがあります。