标题栏 (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 属性。 标题栏中的子按钮具有以下名称:
  • “最小化”
  • “最大化”或“还原”,
  • “关闭”
  • “上下文帮助”
  • “IME”
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 接口。 标题栏对象提供有关这些子按钮的信息。
  • 由于标题栏未获得焦点且没有默认操作,因此此控件不支持 accDoDefaultActionget_accDefaultAction 方法。

IAccessible 接口