通过

DirectoryList 控件

  • 项目

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

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

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

DirectoryList 控件发布以下 ControlEvents。

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

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

控件属性

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

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

此控件允许用户选择当前所选内容的子文件夹。 借助其他按钮，用户还可以选择当前所选内容中的新文件夹，或在路径中向上提升一个级别。 如果用户在已存在新文件夹的文件夹中选择 “创建新文件夹” 按钮，则不会创建第二个新文件夹，并且选择现有新文件夹的名称进行编辑。