树视图控件 (MSAA UI 元素参考)

注意

本主题介绍 用于 MSAA UI 元素引用的树视图控件 对象。 此处未介绍如何在各种 UI 框架中创建 树视图控件 对象。 请参阅所使用的 UI 框架的 API 参考文档。

树视图控件使用行来连接层次结构中的相关项显示项的分层列表。 每个项由标签和可选位图组成。 Windows 资源管理器使用树视图控件来显示目录。

树视图控件的窗口类名称WC_TREEVIEW,该名称在 Commctrl.h 中定义为“SysTreeView”。

IAccessible 方法

树视图控件支持以下 IAccessible 方法:

方法 评论
accDoDefaultAction 树视图对象本身没有 accDoDefaultAction 方法。 根据树视图中项的 状态 属性,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 树视图对象的 属性是围绕控件的窗口(ROLE_SYSTEM_WINDOW),其 Name 属性和窗口类名与控件相同。 树视图中每个项的 Parent 属性是树视图对象。
get_accRole 树视图对象具有 Role 属性 ROLE_SYSTEM_OUTLINE。 树视图中的每个项都有 Role 属性 ROLE_SYSTEM_OUTLINEITEM
get_accSelection
get_accState 树视图的 状态 属性是以下一个或多个 值的组合STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE
对于树视图项,State 属性包括 STATE_SYSTEM_EXPANDEDSTATE_SYSTEM_COLLAPSED
State 属性的其他可能值包括:
STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_HOTTRACKED
get_accValue 树视图对象没有值。 每个树视图项的 Value 属性是层次结构中项的缩进级别。 例如,在 Windows 资源管理器中,项“Desktop”具有 Value 属性“0”;位于层次结构中下一级别的项“My Computer”具有“1”Value 属性;和每个磁盘驱动器(位于层次结构中的下一级别)都有一个 属性“2”。

笔记

树视图项的 accLocation 属性仅返回项中文本的位置。 由 accLocation 返回的树视图项返回的坐标不包括位于文本左侧的图标。

IAccessible 接口