PathEdit 控件
PathEdit 控件显示一个编辑字段,允许用户选择路径的结束部分。 此控件支持在编辑字段中输入所选文件夹名称或整个路径。 用户还可以输入没有驱动器号的驱动器的通用命名约定 (UNC) 路径。 如果用户为当前卷无效的路径输入结束段,PathEdit 控件无法将焦点传输到下一个控件。
PathEdit 控件、DirectoryCombo和 DirectoryList 控件与相同的字符串值属性相关联。 该属性是用户选择的路径。 在 控件表的“属性”列中输入属性的名称。 此属性必须具有包含至少一个卷和一个子级的初始值。 在 “属性”表的“值”列中指定属性的初始值。
此控件旨在与 PathEdit 和 DirectoryList 控件一起用于 浏览对话框。
控件属性
可以将以下属性用于此控件。 若要使用事件更改属性的值,请将控件订阅到 EventMapping 表中的 ControlEvent,并在 Attribute 列中列出属性的标识符。 在事件列中输入 ControlEvent 的标识符。
属性标识符 | 十六进制位 | 描述 |
---|---|---|
IndirectPropertyName | 这是与控件关联的间接属性的名称。 如果设置了 Indirect 属性位,控件将显示或更改具有此名称的属性的值。 如果设置了 Indirect 属性位,则此名称也是 Control 表的“属性”列中列出的属性的值。 | |
位置 | 控件在对话框中的位置。 将控件左角的宽度、高度和坐标输入到 控件表的 Width、Height、X 和 Y 列。 使用 安装程序单位 长度和距离。 |
|
PropertyName | 这是与此控件关联的属性的名称。 如果未设置间接属性位,控件将显示或更改具有此名称的属性的值。 此属性在 Control 表的属性列中指定。 | |
PropertyValue | 此控件显示或更改的属性的当前值。 如果未设置 Indirect 属性位,则此值为 PropertyName 的值。 如果设置了 Indirect 属性位,则这是 IndirectPropertyName 的值。 如果属性发生更改,控件将反映新值。 | |
文本 | 若要设置文本字符串的字体和字体样式,请使用 {\style} 或 {&style} 作为显示字符字符串的前缀。 其中样式是 TextStyle 表的 TextStyle 列中列出的标识符。 如果两者都不存在,但 DefaultUIFont 属性定义为有效的文本样式,将使用该字体。若要指定用户可以输入的字符数,请在任何字体规范后面追加 {n},其中 n 是正整数。 |
|
可见 | 0x00000000 0x00000001 |
隐藏的控件。 可见控件。 将此位包含在 Control 表的 Attributes 列的位词中, 以使控件在创建时可见或隐藏。 还可以使用 ControlCondition 表隐藏或显示控件。 |
已启用 | 0x00000000 0x00000002 |
处于禁用状态的控制。 处于启用状态的控制。 在 控件 的属性列中将此位包含在位词中,以便在创建时启用控件。 也可以使用 ControlCondition 表启用或禁用控件。 |
沉没 | 0x00000000 0x00000004 |
显示默认视觉样式。 显示具有沉没的 3D 外观的控件。 将这些位包含在 控件表的“属性”列中的位词中。 |
间接 | 0x00000000 0x00000008 |
该控件显示或更改 控件表的“属性”列中的属性的值。 该控件显示或更改属性的值,该属性的“标识符”列在控件表的“属性”列中列出。 确定是否间接引用与此控件关联的属性。 |
RTLRO | 0x00000000 0x00000020 |
控件中的文本按从左到右的阅读顺序显示。 控件中的文本以从右到左的阅读顺序显示。 |
RightAligned | 0x00000000 0x00000040 |
控件中的文本与左侧对齐。 控件中的文本与右侧对齐。 |
言论
PathEdit 控件派生自 编辑 控件。
为了与屏幕阅读器兼容,在将 PathEdit 控件作为第一个活动控件创作对话框时,必须将属于编辑字段的文本字段设为 对话框表中的第一个活动控件。 由于静态文本无法获得焦点,因此在创建对话框时,编辑字段将最初按预期获得焦点;这可确保屏幕阅读器显示正确的信息。