DirectoryList コントロール

DirectoryList コントロールは、PathEdit コントロールに現在表示されているパスの一部を表示します。 DirectoryList コントロールは、DirectoryCombo コントロールによって現在表示されているディレクトリの下のフォルダーを表示します。

PathEdit、DirectoryCombo、DirectoryList の各コントロールは、同じ文字列値プロパティに関連付けられます。 このプロパティは、ユーザーが選択したパスです。 Control テーブルの Property 列にプロパティの名前を入力します。 このプロパティには、少なくとも 1 つのボリュームと 1 つのサブレベルを含む初期値が必要です。 Property テーブルの Value 列で、プロパティの初期値を指定します。

このコントロールは、PathEdit と DirectoryList コントロールと共に参照ダイアログで使用することを目的としています。

DirectoryList コントロールは、次の ControlEvents を発行します。

ControlEvent	説明
DirectoryListNew	新しいフォルダーを作成し、編集する名前フィールドを選択します。
IgnoreChange	現在のディレクトリ内のフォルダーを強調表示しますが、開きません。
DirectoryListUp	現在のディレクトリの親を選択します。
DirectoryListOpen	ディレクトリを選択して強調表示します。

Control テーブルの Text フィールドの内容は、DirectoryList コントロールによって表示されません。 代わりに、このフィールドは、コントロールによって表示されるテキストのスタイルを指定し、画面レビュー ユーティリティによって使用されるコントロールの説明を含みます。 テキスト文字列のフォントとフォント スタイルを設定するには、表示される文字の文字列の先頭に {\style} または {&style} を付けます。 ここで、style は、TextStyle テーブルの TextStyle 列に記載されている識別子です。 これらのどちらも存在しないが、DefaultUIFont プロパティが有効なテキスト スタイルとして定義されている場合は、そのフォントが使用されます。 この後の情報は、コントロールの説明として画面レビュー ユーティリティによって読み取られます。 「アクセシビリティ」を参照してください。

コントロールの属性

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

属性識別子	16 進数ビット	説明
IndirectPropertyName		これは、コントロールに関連付けられている間接プロパティの名前です。 Indirect 属性ビットが設定されている場合、コントロールは、この名前を持つプロパティの値を表示または変更します。 Indirect 属性ビットが設定されている場合、この名前は、Control テーブルの Property 列に記載されているプロパティの値でもあります。
Position		ダイアログ ボックス内のコントロールの位置。 Control テーブルの Width、Height、X、Y の各列に、コントロールの幅、高さ、左隅の座標を入力します。 長さと距離にはインストーラー単位を使用します。
PropertyName		これは、このコントロールに関連付けられているプロパティの名前です。 Indirect 属性ビットが設定されていない場合、コントロールは、この名前を持つプロパティの値を表示または変更します。 この属性は、Control テーブルの Property 列で指定されます。
PropertyValue		このコントロールによって表示または変更されるプロパティの現在の値。 Indirect 属性ビットが設定されていない場合、これは PropertyName の値です。 Indirect 属性ビットが設定されている場合、これは IndirectPropertyName の値です。 属性が変更された場合、コントロールは新しい値を反映します。
テキスト		スクリーン リーダーにテキストを表示するには、Control テーブルの Text 列にテキストを入力します。 「アクセシビリティ」を参照してください。
[表示]	0x00000000 0x00000001	表示されないコントロール。 可視のコントロール。 コントロールの作成時にコントロールを表示可能にするか非表示にするかを設定するには、Control テーブルの Attributes 列のビット ワードにこのビットを含めます。 ControlCondition テーブルを使用して、コントロールの非表示または表示を設定することもできます。
有効	0x00000000 0x00000002	無効状態のコントロール。 有効状態のコントロール。 作成時にコントロールを有効にするには、Control の Attributes 列のビット ワードにこのビットを含めます。 ControlCondition テーブルを使用して、コントロールを有効または無効にすることもできます。
Sunken	0x00000000 0x00000004	既定の表示スタイルを表示します。 浮き彫りの 3D の外観を使用してコントロールを表示します。 Control テーブルの Attributes 列のビット ワードにこれらのビットを含めます。
間接	0x00000000 0x00000008	コントロールは、Control テーブルの Property 列内にあるプロパティの値を表示または変更します。 コントロールは、Control テーブルの Property 列に記載されている識別子を持つプロパティの値を表示または変更します。 このコントロールに関連付けられているプロパティが間接的に参照されるかどうかを決定します。
RTLRO	0x00000000 0x00000020	コントロール内のテキストは、左から右への読み取り順序で表示されます。 コントロール内のテキストは、右から左への読み取り順序で表示されます。
RightAligned	0x00000000 0x00000040	コントロール内のテキストは、左揃えになります。 コントロール内のテキストは、右揃えになります。
LeftScroll	0x00000000 0x00000080	スクロール バーは、コントロールの右側に配置されます。 スクロール バーは、コントロールの左側に配置されます。
BiDi コントロール	0x000000E0	RTLRO、RightAligned、LeftScroll の各属性の組み合わせに対してこの値を設定します。

解説

このコントロールは、CreateWindowEx 関数を使用して、WC_LISTVIEW クラスから作成できます。 LVS_LIST、LVS_EDITLABELS、WS_VSCROLL、LVS_SHAREIMAGELISTS、LVS_AUTOARRANGE、LVS_SINGLESEL、WS_BORDER、LVS_SORTASCENDING、WS_CHILD、WS_GROUP、WS_TABSTOP の各スタイルがあります。

このコントロールを使用すると、ユーザーは現在選択されているサブフォルダーを選択できます。 追加のボタンを使用すると、ユーザーは現在の選択範囲で新しいフォルダーを選択したり、パスの 1 レベル上のフォルダーを選択したりすることもできます。 新しいフォルダーが既に存在するフォルダーでユーザーが [新しいフォルダーの作成] ボタンを選択した場合、2 つ目の新しいフォルダーは作成されず、既存の新しいフォルダーの名前が編集用に選択されます。