MSAA UI 元素引用) (树视图控件
注意
本主题介绍用于 MSAA UI 元素引用的 树视图控件 对象。 此处不介绍如何在各种 UI 框架中创建 树视图控件 对象。 请参阅所使用的 UI 框架的 API 参考文档。
树视图控件使用线条来连接层次结构中的相关项显示项的分层列表。 每个项都包含一个标签和一个可选位图。 Windows 资源管理器使用树视图控件来显示目录。
树视图控件的窗口类名WC_TREEVIEW，在 Commctrl.h 中定义为“SysTreeView”。
IAccessible 方法
树视图控件支持以下 IAccessible 方法：
| 方法 | 注释 |
|---|---|
| accDoDefaultAction | 树视图对象本身没有 accDoDefaultAction 方法。 根据树视图中项的 State 属性， accDoDefaultAction 会展开或折叠指定的项。 |
| accHitTest | |
| accLocation | |
| accNavigate | |
| accSelect |
IAccessible 属性
树视图控件支持以下 IAccessible 属性：
| 属性 | 注释 |
|---|---|
| get_accChild | |
| get_accChildCount | 树视图对象的 ChildCount 属性是树视图中包含的项数。 每个树视图项的 ChildCount 属性为零。 |
| get_accDefaultAction | 树视图对象本身没有 DefaultAction 属性。 展开的树视图中的项具有“Collapse”作为其 DefaultAction 属性，未展开的项具有“Expand”作为其 DefaultAction 属性。 |
| get_accDescription | |
| get_accFocus | |
| get_accHelp | |
| get_accHelpTopic | |
| get_accKeyboardShortcut | |
| get_accName | 树视图对象的 Name 属性是从控件的窗口文本 (或描述文字) 获取的。 此文本不随树视图控件一起显示，因此服务器开发人员必须在控件的资源定义语句中提供有意义的文本，以帮助客户端实用工具的用户识别控件。 树视图中项的 Name 属性是树视图项中显示的文本。 |
| get_accParent | 树视图对象的 Parent 属性是一个窗口 ( ROLE_SYSTEM_WINDOW 控件周围的) ，并且具有与控件相同的 Name 属性和窗口类名称。 树视图中每个项的 Parent 属性都是树视图对象。 |
| get_accRole | 树视图对象具有 Role 属性ROLE_SYSTEM_OUTLINE。 树视图中的每一项都有 Role 属性 ROLE_SYSTEM_OUTLINEITEM。 |
| get_accSelection | |
| get_accState | 树视图的 State 属性是以下一个或多个 值的组合： STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE 对于树视图项， State 属性包括 STATE_SYSTEM_EXPANDED 或 STATE_SYSTEM_COLLAPSED。 State 属性的其他可能值包括： STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | | STATE_SYSTEM_SELECTABLESTATE_SYSTEM_SELECTED | STATE_SYSTEM_HOTTRACKED |
| get_accValue | 树视图对象没有值。 每个树视图项的 Value 属性是层次结构中项的缩进级别。 例如，在 Windows 资源管理器中，项“桌面”的 Value 属性为“0”;项“我的计算机”位于层次结构中的下一个级别，其 Value 属性为“1”;和位于层次结构中下一级别的每个磁盘驱动器都有 一个 Value 属性“2”。 |
说明
树视图项的 accLocation 属性仅返回项目中文本的位置。 accLocation 为树视图项返回的坐标不包括位于文本左侧的图标。