通过

标题栏 (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 接口。 标题栏对象提供有关这些子按钮的信息。
  • 由于标题栏未获得焦点且没有默认操作，因此此控件不支持 accDoDefaultAction 和 get_accDefaultAction 方法。

IAccessible 接口