VolumeCostList コントロール
VolumeCostList コントロールは、さまざまなボリュームの選択に関連するコストに関する情報を提供します。 このコントロールには、現在のインストールに関係するすべてのボリュームに加えて、属性ビットで指定されている種類のすべてのボリュームが表示されます。 必要なディスク領域が一部のドライブで使用可能な容量を超える場合は、表でそのボリュームが強調表示されます。 列のヘッダーをクリックすると、選んだ列に従ってボリュームが並べ替えられます。
コントロールの列の見出しには次の文字列が使われ、これは UIText テーブルで指定する必要があります。
- VolumeCostAvailable
- VolumeCostDifference
- VolumeCostRequired
- VolumeCostSize
- VolumeCostVolume
次の 4 つのローカライズされた文字列は、ファイルのサイズの書式設定に使用されます。
- [サイズ]
- KB
- MB
- GB
作成者は、フォント指定の後に列の幅を追加することで、VolumeCostList コントロールの列幅を設定できます。 列の幅は、一連の正の整数を中かっこで囲んで入力します。 空の中かっこまたは {0} を入力すると、列は非表示になります。 負の値または正の整数に変換できない文字列は、無効な列幅です。 系列で無効な列幅が見つかった場合、残りの列は非表示になります。 最大で 5 つの列の幅を指定できます。
Control テーブルの Text フィールドの内容は、VolumeCostList コントロールでは表示されません。 代わりに、このフィールドでは、コントロールによって表示されるテキストのスタイルと、画面レビュー ユーティリティによって使われるコントロールの説明を指定します。 テキスト文字列のフォントとフォント スタイルを設定するには、表示される文字の文字列の先頭に {\style} または {&style} を付けます。 ここで、style は、TextStyle テーブルの TextStyle 列に記載されている識別子です。 これらのどちらも存在しないが、DefaultUIFont プロパティが有効なテキスト スタイルとして定義されている場合は、そのフォントが使用されます。 この後の情報は、コントロールの説明として画面レビュー ユーティリティによって読み取られます。 「アクセシビリティ」を参照してください。
VolumeCostList コントロールにはプロパティが関連付けられていないため、ユーザーが PathEdit コントロール、Browse ダイアログ ボックス、DirectoryList コントロール、または DirectoryCombo コントロールに別のパスを入力しても、インストーラーは VolumeCostControl の内容を更新しないことに注意してください。
コントロールの属性
このコントロールでは次の属性を使用できます。 イベントを使用して属性の値を変更するには、EventMapping テーブルの ControlEvent にコントロールをサブスクライブし、Attribute 列に属性の識別子を記載します。 Event 列に ControlEvent の識別子を入力します。
| 属性識別子 | 16 進数ビット | 説明 |
|---|---|---|
|
Position |
ダイアログ ボックス内のコントロールの位置。 Control テーブルの Width、Height、X、Y の各列に、コントロールの幅、高さ、左隅の座標を入力します。 長さと距離にはインストーラー単位を使用します。 |
|
|
テキスト |
スクリーン リーダーにテキストを表示するには、Control テーブルの Text 列にテキストを入力します。 「アクセシビリティ」を参照してください。 VolumeCostList コントロールで列の幅を設定するには、任意のフォント指定に列の幅を追加します。 列の幅は、一連の正の整数を中かっこで囲んで入力します。 空の中かっこまたは {0} を入力すると、列は非表示になります。 負の値または正の整数に変換できない文字列は、無効な列幅です。 系列で無効な列幅が見つかった場合、残りの列は非表示になります。 最大で 5 つの列の幅を指定できます。 |
|
|
[表示] |
0x00000000 0x00000001 |
表示されないコントロール。 表示されるコントロール。 コントロールの作成時にコントロールを表示可能にするか非表示にするかを設定するには、Control テーブルの Attributes 列のビット ワードにこのビットを含めます。 ControlCondition テーブルを使って、コントロールの非表示または表示を設定することもできます。 |
|
有効 |
0x00000000 0x00000002 |
無効状態のコントロール。 有効状態のコントロール。 作成時にコントロールを有効にするには、Control の Attributes 列のビット ワードにこのビットを含めます。 ControlCondition テーブルを使用して、コントロールを有効または無効にすることもできます。 |
|
Sunken |
0x00000000 0x00000004 |
既定の表示スタイルを表示します。 浮き彫りの 3-D の外観を使用してコントロールを表示します。 Control テーブルの Attributes 列のビット ワードにこれらのビットを含めます。 |
|
RTLRO |
0x00000000 0x00000020 |
コントロールには、左から右に読むテキストが表示されます。 コントロールには、右から左に読むテキストが表示されます。 |
|
RightAligned |
0x00000000 0x00000040 |
コントロール内のテキストは、左揃えになります。 コントロール内のテキストは、右揃えになります。 |
|
LeftScroll |
0x00000000 0x00000080 |
スクロール バーは、コントロールの右側に配置されます。 スクロール バーは、コントロールの左側に配置されます。 |
|
BiDi |
0x000000E0 |
RTLRO、RightAligned、LeftScroll の各属性の組み合わせに対してこの値を設定します。 |
|
RemovableVolume |
0x00010000 |
コントロールにリムーバブル ドライブの一覧を表示します。 Control テーブルの Attributes 列のビット ワードに含めます。 |
|
FixedVolume |
0x00020000 |
コントロールに固定内蔵ハード ドライブの一覧を表示します。 Control テーブルの Attributes 列のビット ワードに含めます。 |
|
RemoteVolume |
0x00040000 |
コントロールにリモート ボリュームの一覧を表示します。 Control テーブルの Attributes 列のビット ワードに含めます。 |
|
CDROMVolume |
0x00080000 |
コントロールに CD-ROM ボリュームの一覧を表示します。 Control テーブルの Attributes 列のビット ワードに含めます。 |
|
RAMDiskVolume |
0x00100000 |
コントロールに RAM ディスクの一覧を表示します。 Control テーブルの Attributes 列のビット ワードに含めます。 |
|
FloppyVolume |
0x00200000 |
コントロールにフロッピー ドライブの一覧を表示します。 Control テーブルの Attributes 列のビット ワードに含めます。 |
|
ControlShowRollbackCost |
0x00000000 0x00400000 |
PROMPTROLLBACKCOST が P で、この属性が設定されていない場合、VolumeCostList コントロールによって表示されるコストに、ロールバック バックアップ ファイルは含まれません。 PROMPTROLLBACKCOST が P で、この属性が設定されている場合、VolumeCostList コントロールによって表示されるコストに、ロールバック バックアップ ファイルが含まれます。 PROMPTROLLBACKCOST が D または F の場合、このコントロール属性は無視されます。PROMPTROLLBACKCOST が F の場合、ロールバック バックアップ ファイルのコストが含まれます。 PROMPTROLLBACKCOST が D の場合、または DISABLEROLLBACK が 1 の場合、ロールバック バックアップ ファイルのコストは含まれません。 |
解説
このコントロールは、CreateWindowEx 関数を使用して、WC_LISTVIEW クラスから作成できます。 LVS_REPORT、WS_VSCROLL、WS_HSCROLL、LVS_SHAREIMAGELISTS、LVS_AUTOARRANGE、LVS_SINGLESEL、WS_BORDER、WS_CHILD、WS_TABSTOP、WS_GROUP の各スタイルがあります。