更新: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 自动化树概述。
控件视图  | 
内容视图  | 
|---|---|
  | 
  | 
必需的 UI 自动化属性
下表列出值或定义与进度栏控件密切相关的 UI 自动化属性。有关 UI 自动化属性的更多信息,请参见客户端的 UI 自动化属性。
UI 自动化属性  | 
值  | 
说明  | 
|---|---|---|
AutomationIdProperty()  | 
请参见“说明”。  | 
此属性的值在应用程序中的所有控件中必须保持唯一。  | 
请参见“说明”。  | 
状态栏的边框必须包围其中所含的所有控件。  | 
|
请参见“说明”。  | 
有边框时支持。如果边框中并非每个点都是可单击的,那么,在执行专用的命中测试时,请重写并提供一个可单击的点。  | 
|
请参见“说明”。  | 
如果该控件可以接收键盘焦点,则它必须支持此属性。  | 
|
请参见“说明”。  | 
状态栏控件不需要名称,除非应用程序中使用了多个状态栏。在这种情况下,请使用诸如“Internet 状态”或“应用程序状态”之类的名称来区分每个状态栏。  | 
|
Null  | 
状态栏控件通常没有标签。  | 
|
StatusBar  | 
此值对于所有的 UI 框架均相同。  | 
|
“状态栏”  | 
与 StatusBar 控件类型对应的本地化字符串。  | 
|
True  | 
状态栏控件始终包含内容。  | 
|
True  | 
状态栏控件始终是一个控件。  | 
|
视情况而定  | 
对于此属性,如果状态栏控件当前在屏幕上不可见,则将返回 True。  | 
|
视情况而定  | 
控件方向值:水平或垂直。  | 
|
False  | 
不适用  | 
|
""  | 
状态栏没有帮助文本。  | 
|
Null  | 
状态栏没有快捷键。  | 
|
""  | 
状态栏不接收键盘焦点。辅助技术能够以编程方式读取内容。  | 
必需的 UI 自动化控件模式
下表列出状态栏控件必须支持的 UI 自动化控件模式。有关控件模式的更多信息,请参见 UI 自动化控件模式概述。
控件模式/模式属性  | 
支持/值  | 
说明  | 
|---|---|---|
可选  | 
状态栏控件应当支持 Grid 控件模式,以便可以监视各组成部分并轻松引用以获取信息。  | 
必需的 UI 自动化事件
下表列出所有状态栏控件必须支持的 UI 自动化事件。有关事件的更多信息,请参见 UI 自动化事件概述。
UI 自动化事件  | 
支持  | 
说明  | 
|---|---|---|
BoundingRectangleProperty property-changed 事件。  | 
必需  | 
无  | 
IsOffscreenProperty property-changed 事件。  | 
必需  | 
无  | 
IsEnabledProperty property-changed 事件。  | 
必需  | 
无  | 
必需  | 
无  | 
|
必需  | 
无  |