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

注意注意

本文档的目标读者是欲使用 System.Windows.Automation 命名空间中定义的托管 UI Automation类的 .NET Framework 开发人员。有关 UI Automation的最新信息,请参见 Windows Automation API: UI Automation(Windows 自动化 API:UI 自动化)。

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

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

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

本主题包括下列各节。

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

必需的 UI 自动化树结构

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

控件视图

内容视图

StatusBar

  • Edit(0 个或多个)

  • Progress Bar(0 个或多个)

  • Image(0 个或多个)

  • Button(0 个或多个)

StatusBar

  • Edit(0 个或多个)

  • ProgressBar(0 个或多个)

  • Image(0 个或多个)

  • Button(0 个或多个)

必需的 UI 自动化属性

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

UI Automation属性

注释

AutomationIdProperty

请参见“说明”。

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

BoundingRectangleProperty

请参见“说明”。

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

ClickablePointProperty

请参见“说明”。

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

IsKeyboardFocusableProperty

请参见“说明”。

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

NameProperty

请参见“说明”。

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

LabeledByProperty

Null

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

ControlTypeProperty

StatusBar

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

LocalizedControlTypeProperty

“状态栏”

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

IsContentElementProperty

True

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

IsControlElementProperty

True

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

IsOffscreenProperty

视情况而定

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

OrientationProperty

视情况而定

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

IsKeyboardFocusableProperty

False

不适用

AcceleratorKeyProperty

Null

状态栏没有快捷键。

必需的 UI 自动化控件模式

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

控件模式

支持

注释

IGridProvider

可选

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

必需的 UI 自动化事件

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

UI Automation事件

支持

注释

BoundingRectangleProperty property-changed 事件。

必需

IsOffscreenProperty property-changed 事件。

必需

IsEnabledProperty property-changed 事件。

必需

AutomationFocusChangedEvent

必需

StructureChangedEvent

必需

请参见

参考

StatusBar

概念

UI 自动化控件类型概述

UI 自动化概述