.gif "注意") 注意 |
|---|
本文档的目标读者是欲使用 System.Windows.Automation 命名空间中定义的托管 UI Automation类的 .NET Framework 开发人员。有关 UI Automation的最新信息，请参见 Windows Automation API: UI Automation（Windows 自动化 API：UI 自动化）。 |
本主题介绍 UI Automation对 Image 控件类型的支持。 在 UI Automation中，控件类型是一组条件，控件必须满足这些条件才能使用 ControlTypeProperty 属性。 这些条件包括 UI Automation树结构的特定准则、UI Automation属性值和控件模式。
用作图标、信息性图形和图表的图像控件将支持 Image 控件类型。 用作背景和水印图像的控件将不支持 Image 控件类型。
下面几节定义了 Image 控件类型必需的 UI Automation树结构、属性、控件模式和事件。 UI Automation的要求适用于所有图像控件，无论控件是 Windows Presentation Foundation (WPF)、Win32 还是 Windows Forms。
本主题包括下列各节。
- 必需的 UI 自动化树结构
- 必需的 UI 自动化属性
- 必需的 UI 自动化控件模式
- 必需的 UI 自动化事件
- 相关主题
必需的 UI 自动化树结构
下表描述了与图像控件有关的 UI Automation树的控件视图和内容视图，以及每个视图中可包含的内容。 有关 UI Automation树的更多信息，请参见 UI 自动化树概述。
控件视图 |
内容视图 |
|---|---|
Image |
图像（取决于图像是否包含信息（基于 IsContentElement 属性的值）） |
必需的 UI 自动化属性
下表列出了值或定义与 Image 控件类型密切关系的 UI Automation属性。 有关 UI Automation 属性的更多信息，请参见 客户端的 UI 自动化属性。
UI Automation属性 |
值 |
注释 |
|---|---|---|
请参见“说明”。 |
此属性的值在应用程序的所有控件中都必须保持唯一。 |
|
请参见“说明”。 |
包含整个控件的最外面的矩形。 |
|
请参见“说明”。 |
图像控件的可单击点必须是该图像控件边框中的一个点。 |
|
请参见“说明”。 |
如果该控件可以接收键盘焦点，则它必须支持此属性。 |
|
请参见“说明”。 |
对于所有包含信息的图像控件，必须公开 Name 属性。 对此信息的编程访问要求提供与图形等效的文本。 如果图像控件纯粹是装饰性的，则它只能显示在 UI Automation树的控件视图中，且不需要具有名称。 UI 框架必须支持图像中可从图像框架设置的 ALT（即替换文字）属性。 此属性然后将映射到 UI Automation Name 属性。 |
|
请参见“说明”。 |
如果存在静态文本标签，则此属性必须公开对该控件的引用。 |
|
Image |
此值对于所有的 UI 框架均相同。 |
|
“图像” |
与 Image 控件类型相对应的本地化字符串。 |
|
请参见“说明”。 |
如果图像控件包含尚未对最终用户公开的有意义信息，则该控件必须包括在 UI Automation树的内容视图中。 |
|
True |
图像控件始终包括在 UI Automation树的控件视图中。 |
|
请参见“说明”。 |
HelpText 属性公开本地化字符串，该字符串描述控件的实际可视外观（例如，带有白色“X”的红色方框）或与该图像关联的其他工具提示信息。 当需要详细说明来传达有关图像控件（例如复杂图表或图示）的更多信息时， 必须支持此属性。 此属性映射到 HTML LongDesc 标记和可缩放的向量图形 (SVG) Desc 标记。 使用图像控件的开发人员必须支持一个属性，以允许在控件上设置可视说明。 此属性必须映射到 UI 自动化 VisualDescription 属性。 |
|
请参见“说明”。 |
如果图像控件表示屏幕上特定项目的状态信息，则该控件应当包含在该项目中。 如果图像包含在项目中，该项目必须支持状态属性，并在状态更改时发出相应的通知。 如果图像是独立控件，并且正在传送状态，则必须支持此属性。 |
必需的 UI 自动化控件模式
下表列出了所有图像控件必须支持的 UI Automation控件模式。 有关控件模式的更多信息，请参见 UI 自动化控件模式概述。
控件模式 |
支持 |
注释 |
|---|---|---|
视情况而定 |
如果图像控件在网格容器中，则该控件支持 Grid Item 模式。 |
|
视情况而定 |
如果图像控件在具有标头控件的容器中，则该控件支持 Table Item 模式。 |
|
从不 |
如果图像控件包含可单击的图像，该控件应当支持对 Invoke 模式进行支持的控件类型（例如 Button 控件类型）。 |
|
从不 |
图像控件不应支持 Selection Item 模式。 |
必需的 UI 自动化事件
下表列出了所有图像控件必须支持的 UI Automation事件。 有关事件的更多信息，请参见 UI 自动化事件概述。
UI Automation事件 |
支持 |
注释 |
|---|---|---|
从不 |
无 |
|
从不 |
无 |
|
从不 |
无 |
|
从不 |
无 |
|
BoundingRectangleProperty property-changed 事件。 |
必需 |
无 |
IsOffscreenProperty property-changed 事件。 |
必需 |
无 |
IsEnabledProperty property-changed 事件。 |
必需 |
无 |
NameProperty property-changed 事件。 |
必需 |
无 |
必需 |
无 |
|
必需 |
无 |