标题栏 (MSAA UI 元素参考)
注意
本主题介绍用于 MSAA UI 元素参考的 标题栏 对象。 此处未介绍如何在各种 UI 框架中创建 标题栏 对象。 请参阅所使用的 UI 框架的 API 参考文档。
窗口顶部的标题栏显示应用程序定义的图标和文本行。 文本指定应用程序的名称,并指示窗口的用途。 标题栏还使用户能够使用鼠标或其他指针设备移动窗口。
标题栏包含至少三个小按钮,用于最小化、最大化或还原,以及关闭与标题栏关联的窗口。 标题栏还包含上下文相关的“帮助”按钮。 在 Windows 操作系统的 Far-East 版本中运行的应用程序可能还包含输入法编辑器 (输入法) 按钮。 Microsoft Active Accessibility 将这些按钮公开为标题栏的子元素。
IAccessible 方法
标题栏支持以下 IAccessible 方法:
IAccessible 属性
标题栏支持以下 IAccessible 属性:
属性 | 注释 |
---|---|
get_accChildCount | ChildCount 属性为 5。 ChildCount 属性包括 IME 和上下文相关帮助按钮,即使它们未显示也是如此。 未显示的按钮具有 State 属性 STATE_SYSTEM_INVISIBLE。 |
get_accDescription | 标题栏本身的 Description 属性为:“显示窗口的名称,并包含用于操作窗口的控件。标题栏中的子按钮具有以下说明:
|
get_accName | 标题栏本身不支持 Name 属性。 标题栏中的子按钮具有以下名称:
|
get_accParent | 标题栏的 Parent 属性是main应用程序窗口 ( ROLE_SYSTEM_WINDOW) 具有与标题栏相同的应用程序定义的窗口类名称。 |
get_accRole | Role属性ROLE_SYSTEM_TITLEBAR。 标题栏中的子按钮具有 Role 属性 ROLE_SYSTEM_PUSHBUTTON。 |
get_accState | 标题栏和子按钮的 State 属性可以是以下一个或多个 值的组合: STATE_SYSTEM_FOCUSABLE STATE_SYSTEM_INVISIBLE STATE_SYSTEM_OFFSCREEN STATE_SYSTEM_UNAVAILABLE STATE_SYSTEM_PRESSED |
get_accValue | Value 属性是一个字符串,与标题栏中显示的文本相同。 |
说明
- 尽管应用程序的标题栏具有 State 属性标志STATE_SYSTEM_FOCUSABLE,但它从未STATE_SYSTEM_FOCUSEDState 标志。 将焦点设置为标题栏对象可聚焦应用程序窗口。
- 由于标题栏对象不支持 get_accChild,因此标题栏上的按钮是简单元素。 它们本身不支持 IAccessible 接口。 标题栏对象提供有关这些子按钮的信息。
- 由于标题栏未获得焦点且没有默认操作,因此此控件不支持 accDoDefaultAction 和 get_accDefaultAction 方法。