DirectoryList コントロール
DirectoryList コントロールは、PathEdit コントロールに現在表示されているパスの一部を表示します。 DirectoryList コントロールには、DirectoryCombo コントロールによって現在表示されているディレクトリの下にフォルダーが表示されます。
PathEdit、DirectoryCombo、および DirectoryList コントロールは、同じ文字列値プロパティに関連付けられています。 このプロパティは、ユーザーが選択したパスです。 Control テーブルの Property 列にプロパティの名前入力します。 このプロパティには、少なくとも 1 つのボリュームと 1 つのサブレベルを含む初期値が必要です。 Property テーブルの [値] 列にプロパティの初期値指定します。
このコントロールは、PathEdit および DirectoryList コントロールと共に 参照ダイアログ で使用することを目的としています。
DirectoryList コントロールは、次の ControlEvent を発行します。
ControlEvent | 形容 |
---|---|
DirectoryListNew | 新しいフォルダーを作成し、編集する名前フィールドを選択します。 |
IgnoreChange の | 現在のディレクトリ内のフォルダーを強調表示しますが、開きません。 |
DirectoryListUp | 現在のディレクトリの親を選択します。 |
DirectoryListOpen | ディレクトリを選択して強調表示します。 |
コントロール テーブル の [テキスト] フィールドの内容は、DirectoryList コントロールには表示されません。 代わりに、このフィールドは、コントロールによって表示されるテキストのスタイルを指定し、画面レビュー ユーティリティで使用されるコントロールの説明を含みます。 テキスト文字列のフォントとフォント スタイルを設定するには、表示される文字の文字列の先頭に {\style} または {&スタイル} を付けます。 ここで、style は、TextStyle テーブルの TextStyle 列に一覧表示される識別子です。 どちらも存在しないが、DefaultUIFont プロパティが有効なテキスト スタイルとして定義されている場合は、そのフォントが使用されます。 この後の情報は、コントロールの説明として画面レビュー ユーティリティによって読み取られます。 アクセシビリティ を参照してください。
コントロール属性
このコントロールでは、次の属性を使用できます。 イベントを使用して属性の値を変更するには、EventMapping テーブルの ControlEvent コントロールをサブスクライブし、[属性] 列に属性の識別子を一覧表示します。 [イベント] 列に ControlEvent の識別子を入力します。
属性識別子 | 16 進数ビット | 形容 |
---|---|---|
IndirectPropertyName | これは、コントロールに関連付けられている間接プロパティの名前です。 間接属性ビットが設定されている場合、コントロールは、この名前を持つプロパティの値を表示または変更します。 間接属性ビットが設定されている場合、この名前は、Control テーブルの [プロパティ] 列に表示されるプロパティの値。 | |
位置 | ダイアログ ボックス内のコントロールの位置。 コントロールの左隅のコントロールの幅、高さ、および座標を、Control テーブルの [幅]、[高さ]、[X]、および [Y] 列に入力。 長さと距離 インストーラー ユニットを使用します。 |
|
PropertyName | これは、このコントロールに関連付けられているプロパティの名前です。 Indirect 属性ビットが設定されていない場合、コントロールは、この名前を持つプロパティの値を表示または変更します。 この属性は、コントロール テーブルの [プロパティ] 列で指定します。 | |
PropertyValue | このコントロールによって表示または変更されたプロパティの現在の値。 間接属性ビットが設定されていない場合、これは PropertyName の値です。 Indirect 属性ビットが設定されている場合、これは IndirectPropertyName の値です。 属性が変更されると、コントロールには新しい値が反映されます。 | |
テキスト | スクリーン リーダーにテキストを表示するには、コントロール テーブルの [テキスト] 列にテキスト入力します。 アクセシビリティ を参照してください。 | |
表示 | 0x00000000 0x00000001 |
非表示のコントロール。 表示コントロール。 コントロール テーブルの [属性] 列のビット ワードにこのビットを含。コントロールを作成時に表示または非表示にします。 ControlCondition テーブルを使用して、コントロールを非表示または表示することもできます。 |
Enabled | 0x00000000 0x00000002 |
無効な状態のコントロール。 有効な状態での制御。 作成時にコントロールを有効にするには、コントロール の [属性] 列のビット ワードにこのビットを含めます。 ControlCondition テーブルを使用して、コントロールを有効または無効にすることもできます。 |
沈没 | 0x00000000 0x00000004 |
既定の表示スタイルを表示します。 沈んだ 3D の外観でコントロールを表示します。 これらのビットは、コントロール テーブルの [属性] 列のビット ワード含めます。 |
間接 の | 0x00000000 0x00000008 |
コントロールは、コントロール テーブルの 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 つ目の新しいフォルダーは作成されず、既存の新しいフォルダーの名前が編集用に選択されます。