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

更新：2007 年 11 月

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

用作图标、信息性图形和图表的图像控件将支持 Image 控件类型。背景图像和水印图像不支持 Image 控件类型。

下面几节定义了 Image 控件类型必需的 UI 自动化树结构、属性、控件模式和事件。UI 自动化的要求适用于所有图像控件，无论控件是 Windows Presentation Foundation (WPF)、Win32 还是 Windows 窗体。

本主题包括下列各节。

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

必需的 UI 自动化树结构

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

控件视图	内容视图
Image	取决于图像是否包含信息（基于 IsContentElement 属性的值）

必需的 UI 自动化属性

下表列出了值或定义与 Image 控件类型密切关系的 UI 自动化属性。有关 UI 自动化属性的更多信息，请参见客户端的 UI 自动化属性。

UI 自动化属性	值	说明
AutomationIdProperty()	请参见“说明”。	此属性的值必须在应用程序中的所有控件中保持唯一。
BoundingRectangleProperty	请参见“说明”。	包含整个控件的最外面的矩形。
ClickablePointProperty	请参见“说明”。	图像控件的可单击点必须是该图像控件边框中的一个点。
IsKeyboardFocusableProperty	请参见“说明”。	如果该控件可以接收键盘焦点，则它必须支持此属性。
NameProperty	请参见“说明”。	对于所有包含信息的图像控件，必须公开 Name 属性。对此信息的编程访问要求提供与图形等效的文本。如果图像控件纯粹是装饰性的，则它只能显示在 UI 自动化树的控件视图中，且不需要具有名称。UI 框架必须支持图像中可从图像框架设置的 ALT（即替换文字）属性。此属性然后将映射到 UI 自动化 Name 属性。
LabeledByProperty	请参见“说明”。	如果存在静态文本标签，则此属性必须公开对该控件的引用。
ControlTypeProperty	Image	此值对于所有的 UI 框架均相同。
LocalizedControlTypeProperty	“图像”	与 Image 控件类型相对应的本地化字符串。
IsContentElementProperty	请参见“说明”。	如果图像控件包含尚未对最终用户公开的有意义信息，则该控件必须包括在 UI 自动化树的内容视图中。
IsControlElementProperty	True	图像控件始终包括在 UI 自动化树的控件视图中。
HelpTextProperty	请参见“说明”。	HelpText 属性公开本地化字符串，该字符串描述控件的实际可视外观（例如带有白色“X”的红色方框）。 当需要详细说明来传达有关图像控件（例如复杂图表或图示）的更多信息时，必须支持此属性。此属性映射到 HTML LongDesc 标记和 可缩放的向量图形 (SVG) Desc 标记。使用图像控件的开发人员必须支持一个属性，以允许在控件上设置可视说明。此属性必须映射到 UI 自动化 VisualDescription 属性。 当图像作为内容控件使用时，通常需要进行此映射。
ItemStatusProperty	请参见“说明”。	如果图像控件表示屏幕上特定项目的状态信息，则该控件应当包含在该项目中。如果图像包含在项目中，该项目必须支持状态属性，并在状态更改时发出相应的通知。 如果图像是独立控件，并且正在传送状态，则必须支持此属性。

必需的 UI 自动化控件模式

下表列出了所有图像控件必须支持的 UI 自动化控件模式。有关控件模式的更多信息，请参见 UI 自动化控件模式概述。

控件模式/模式属性	支持/值	说明
IGridItemProvider	视情况而定	如果图像控件在网格容器中，则该控件支持 Grid Item 模式。
ITableItemProvider	视情况而定	如果图像控件在具有标头控件的容器中，则该控件支持 Table Item 模式。
IInvokeProvider	从不	如果图像控件包含可单击的图像，该控件应当支持对 Invoke 模式进行支持的控件类型（例如 Button 控件类型）。
ISelectionItemProvider	从不	图像控件不应支持 Selection Item 模式。

必需的 UI 自动化事件

下表列出了所有图像控件必须支持的 UI 自动化事件。有关事件的更多信息，请参见 UI 自动化事件概述。

UI 自动化事件	支持	说明
InvokedEvent	从不	无
ElementAddedToSelectionEvent	从不	无
ElementRemovedFromSelectionEvent	从不	无
ElementSelectedEvent	从不	无
BoundingRectangleProperty property-changed 事件。	必需	无
IsOffscreenProperty property-changed 事件。	必需	无
IsEnabledProperty property-changed 事件。	必需	无
NameProperty property-changed 事件。	必需	无
AutomationFocusChangedEvent	必需	无
StructureChangedEvent	必需	无

请参见

概念

UI 自动化控件类型概述

UI 自动化概述

参考

Image