DirectoryList 控件

DirectoryList 控件显示 PathEdit 控件中当前显示的路径的一部分。 DirectoryList 控件显示 DirectoryCombo 控件当前显示的目录下的文件夹。

PathEdit、DirectoryCombo 和 DirectoryList 控件与相同的字符串值属性相关联。 该属性是用户选择的路径。 在 Control 表的 Property 列中输入属性的名称。 此属性的初始值必须至少包含一个卷和一个子级别。 在 Property 表的 Value 列中指定属性的初始值。

此控件旨在与 PathEdit 和 DirectoryList 控件一起用于 Browse 对话框。

DirectoryList 控件发布以下 ControlEvents。

ControlEvent	说明
DirectoryListNew	创建一个新文件夹并选择要编辑的名称字段。
IgnoreChange	突出显示但不打开当前目录中的文件夹。
DirectoryListUp	选择当前目录的父级。
DirectoryListOpen	选择并突出显示目录。

DirectoryList 控件永远不会显示 Control 表的 Text 字段的内容。 此字段指定控件要显示的文本样式，并包含屏幕查看实用工具所用控件的说明。 若要设置文本字符串的字体和字体样式，请在显示的字符串前面加上 {\style} 或 {&style}。 其中 style 是 TextStyle 表的 TextStyle 列中列出的标识符。 如果这两者都不存在，但 DefaultUIFont 属性定义为有效的文本样式，则会使用该字体。 屏幕查看实用工具会将其下信息读取为控件的说明。 请参阅辅助功能。

控件属性

可将以下属性与此控件一起使用。 若要使用事件更改属性的值，请将控件订阅到 EventMapping 表中的 ControlEvent，并在 Attribute 列中列出该属性的标识符。 在 Event 列中输入 ControlEvent 的标识符。

属性标识符	十六进制位	说明
IndirectPropertyName		这是与控件关联的 Indirect 属性的名称。 如果设置了 Indirect 属性位，控件将显示或更改具有此名称的属性的值。 如果设置了 Indirect 属性位，此名称也是 Control 表的 Property 列中列出的属性的值。
位置		控件在对话框中的位置。 在 Control 表的 Width、Height、X 和 Y 列中分别输入控件的宽度、高度和控件左角的坐标。 使用安装程序单位表示长度和距离。
PropertyName		这是与此控件关联的属性的名称。 如果未设置 Indirect 属性位，控件将显示或更改具有此名称的属性的值。 此属性在 Control 表的 Property 列中指定。
PropertyValue		此控件显示或更改的属性的当前值。 如果未设置 Indirect 属性位，则这是 PropertyName 的值。 如果设置了 Indirect 属性位，则这是 IndirectPropertyName 的值。 如果属性发生更改，控件将反映新值。
文本		若要在屏幕阅读器中显示文本，请在 Control 表的 Text 列中输入文本。 请参阅辅助功能。
Visible	0x00000000 0x00000001	隐藏的控件。 可见控件。 将此位包含在 Control 表中 Attributes 列的位字中，以使控件在创建时可见或隐藏。 还可使用 ControlCondition 表来隐藏或显示控件。
已启用	0x00000000 0x00000002	处于禁用状态的控件。 处于启用状态的控件。 将此位包含在 Control 的 Attributes 列中的位字中，以在创建控件时启用该控件。 还可使用 ControlCondition 表启用或禁用控件。
Sunken	0x00000000 0x00000004	显示默认视觉样式。 显示呈凹陷三维外观的控件。 将这些位包含在 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 样式。

用户可以通过此控件在当前进行选择期间选择子文件夹。 使用其他按钮，用户还可以在当前进行选择期间选择新文件夹，或者在路径中的更高一个级别进行选择。 如果用户在已存在新文件夹的文件夹中选择“创建新文件夹”按钮，则不会再创建一个新文件夹，并且会选择现有新文件夹的名称进行编辑。