UI 自动化对 StatusBar 控件类型的支持

更新:2007 年 11 月

本主题介绍 UI 自动化对 StatusBar 控件类型的支持。在 UI 自动化中,控件类型是一组条件,控件必须满足这些条件才能使用 ControlTypeProperty 属性。这些条件包括 UI 自动化树结构的特定准则、UI 自动化属性值和控件模式。

状态栏控件显示要在应用程序窗口中查看的对象的有关信息、对象的组件或与该对象在应用程序中的操作相关的上下文信息。

下面各部分定义 StatusBar 控件类型必需的 UI 自动化树结构、属性、控件模式和事件。UI 自动化的要求适用于所有状态栏控件,无论是 Windows Presentation Foundation (WPF)、Win32 还是 Windows 窗体。

本主题包括下列各节。

  • 必需的 UI 自动化树结构
  • 必需的 UI 自动化属性
  • 必需的 UI 自动化控件模式
  • 必需的 UI 自动化事件
  • 相关主题

必需的 UI 自动化树结构

下表描述了与状态栏控件有关的 UI 自动化树的控件视图和内容视图,以及每个视图中可包含的内容。有关 UI 自动化树的更多信息,请参见 UI 自动化树概述

控件视图

内容视图

  • StatusBar

    • 编辑(1 个或多个)

    • 进度栏(0 个或多个)

    • 图像(0 个或多个)

  • StatusBar

  • 编辑(1 个或多个)

  • 进度栏(0 个或多个)

  • 图像(0 个或多个)

必需的 UI 自动化属性

下表列出值或定义与进度栏控件密切相关的 UI 自动化属性。有关 UI 自动化属性的更多信息,请参见客户端的 UI 自动化属性

UI 自动化属性

说明

AutomationIdProperty()

请参见“说明”。

此属性的值在应用程序中的所有控件中必须保持唯一。

BoundingRectangleProperty

请参见“说明”。

状态栏的边框必须包围其中所含的所有控件。

ClickablePointProperty

请参见“说明”。

有边框时支持。如果边框中并非每个点都是可单击的,那么,在执行专用的命中测试时,请重写并提供一个可单击的点。

IsKeyboardFocusableProperty

请参见“说明”。

如果该控件可以接收键盘焦点,则它必须支持此属性。

NameProperty

请参见“说明”。

状态栏控件不需要名称,除非应用程序中使用了多个状态栏。在这种情况下,请使用诸如“Internet 状态”或“应用程序状态”之类的名称来区分每个状态栏。

LabeledByProperty

Null

状态栏控件通常没有标签。

ControlTypeProperty

StatusBar

此值对于所有的 UI 框架均相同。

LocalizedControlTypeProperty

“状态栏”

与 StatusBar 控件类型对应的本地化字符串。

IsContentElementProperty

True

状态栏控件始终包含内容。

IsControlElementProperty

True

状态栏控件始终是一个控件。

IsOffscreenProperty

视情况而定

对于此属性,如果状态栏控件当前在屏幕上不可见,则将返回 True。

OrientationProperty

视情况而定

控件方向值:水平或垂直。

IsKeyboardFocusableProperty

False

不适用

HelpTextProperty

""

状态栏没有帮助文本。

AcceleratorKeyProperty

Null

状态栏没有快捷键。

AccessKeyProperty

""

状态栏不接收键盘焦点。辅助技术能够以编程方式读取内容。

必需的 UI 自动化控件模式

下表列出状态栏控件必须支持的 UI 自动化控件模式。有关控件模式的更多信息,请参见 UI 自动化控件模式概述

控件模式/模式属性

支持/值

说明

IGridProvider

可选

状态栏控件应当支持 Grid 控件模式,以便可以监视各组成部分并轻松引用以获取信息。

必需的 UI 自动化事件

下表列出所有状态栏控件必须支持的 UI 自动化事件。有关事件的更多信息,请参见 UI 自动化事件概述

UI 自动化事件

支持

说明

BoundingRectangleProperty property-changed 事件。

必需

IsOffscreenProperty property-changed 事件。

必需

IsEnabledProperty property-changed 事件。

必需

AutomationFocusChangedEvent

必需

StructureChangedEvent

必需

请参见

概念

UI 自动化控件类型概述

UI 自动化概述

参考

StatusBar