工具栏控件(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 事件。