工具栏控件(MSAA UI 元素参考)

注意

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

工具栏控件包含执行菜单命令的按钮,通常包含在菜单栏下方的窗口中。

工具栏控件的窗口类名称是 TOOLBARCLASSNAME,该名称在 Commctrl.h 中定义为“ToolbarWindow32”。

IAccessible 方法

工具栏控件支持以下 IAccessible 方法:

方法 评论
accDoDefaultAction 工具栏本身支持 accDoDefaultAction 方法。 对于工具栏上的按钮,accDoDefaultAction 调用 PostMessage,其中包含 BM_CLICK 消息以单击指定的按钮。
accHitTest
accLocation
accNavigate
accSelect

IAccessible 属性

工具栏控件支持以下 IAccessible 属性:

财产 评论
get_accChild
get_accChildCount ChildCount 属性是工具栏中包含的控件数。
get_accDefaultAction 工具栏对象本身没有 DefaultAction 属性。 工具栏按钮的 DefaultAction 属性取决于工具栏按钮样式。 具有样式TBSTYLE_DROPDOWN的按钮具有“打开”作为其 DefaultAction 属性。 所有其他工具栏按钮的 DefaultAction 属性为“按”。
get_accDescription
get_accFocus
get_accHelp
get_accHelpTopic
get_accKeyboardShortcut 工具栏没有键盘快捷方式。 但是,如果工具栏的窗口文本包含与号(&)字符,Microsoft Active Accessibility 将返回非 Null 字符串作为 KeyboardShortcut 属性。
get_accName 工具栏的 Name 属性是从控件的窗口文本(或标题)获取的。 此文本未显示在工具栏中,因此服务器开发人员必须在控件的资源定义语句中提供有意义的文本,以帮助客户端实用工具的用户识别控件。 可以使用 SetWindowText 函数设置窗口文本。
get_accParent Parent 属性是围绕控件的窗口(ROLE_SYSTEM_WINDOW),其 名称与控件 属性和窗口类名相同。
get_accRole Role 属性 ROLE_SYSTEM_TOOLBAR
get_accSelection
get_accState 工具栏本身 状态 属性 值为零,这意味着对象可见。 工具栏按钮的 State 属性的可能值为:STATE_SYSTEM_INVISIBLE
STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_MOVEABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE

笔记

工具栏上的按钮发送 EVENT_OBJECT_STATECHANGE 事件。

IAccessible 接口