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

更新：2007 年 11 月

本主题提供有关 ToolTip 控件类型的 UI 自动化支持的信息。在 UI 自动化中，控件类型是一组条件，控件必须满足这些条件才能使用 ControlTypeProperty 属性。这些条件包括 UI 自动化树结构的特定准则、UI 自动化属性值以及控件模式。

工具提示控件是包含文本的弹出窗口。

以下几节定义了 ToolTip 控件类型所需的 UI 自动化树结构、属性、控件模式和事件。UI 自动化要求适用于所有工具提示控件，包括 Windows Presentation Foundation (WPF)、Win32 和 Windows 窗体。

本主题包括下列各节。

必需的 UI 自动化树结构

下表描述了与工具提示控件有关的 UI 自动化树的控件视图和内容视图，并介绍了每个视图中可包含的内容。有关 UI 自动化树的更多信息，请参见 UI 自动化树概述。

控件视图	内容视图
ToolTip 文本（0 个或 1 个）图像（0 个或 1 个）	ToolTip

如果工具提示控件可以接收键盘焦点，则它们仅显示在 UI 自动化树的内容视图中。否则，可以从工具提示所指的 UI 自动化元素上的 HelpTextProperty 中获得工具提示的所有信息。

工具提示应当出现在其信息所指的控件下方。客户端必须侦听 ToolTipOpenedEvent，从而确保以一致的方式获取工具提示中包含的信息。

下表列出了值或定义与工具提示控件密切相关的 UI 自动化属性。有关 UI 自动化属性的更多信息，请参见客户端的 UI 自动化属性。

UI 自动化属性	值	说明
AutomationIdProperty()	请参见“说明”。	此属性的值在应用程序中的所有控件中必须保持唯一。
BoundingRectangleProperty	请参见“说明”。	包含整个控件的最外面的矩形。
ClickablePointProperty	请参见“说明”。	可点击的点应该是工具提示中将关闭此控件的一部分。有些工具提示不具有此功能，因此将没有可点击的点。
IsKeyboardFocusableProperty	请参见“说明”。	如果控件可以接收键盘焦点，则必须支持此属性。
NameProperty	请参见“说明”。	工具提示控件的名称是显示在工具提示内的文本。
LabeledByProperty	Null	工具提示控件始终按其内容自行设置标签。
ControlTypeProperty	ToolTip	此值对于所有的 UI 框架均相同。
LocalizedControlTypeProperty	"工具提示"	与 ToolTip 控件类型相对应的本地化字符串。
IsContentElementProperty	视情况而定	如果工具提示控件可以接收键盘焦点，则它必须在树的内容视图中。如果它仅仅是文本，则它的表现形式为产生它的控件的 HelpTextProperty。
IsControlElementProperty	True	工具提示控件必须总是一个控件。
HelpTextProperty	Null	工具提示控件的 HelpText 属性将总是 null。

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

控件模式/模式属性	支持/值	说明
IWindowProvider	视情况而定	可以通过单击 UI 项来关闭的工具提示必须支持 WindowPattern，这样它们才能自动关闭。
ITextProvider	视情况而定	并非所有的 UI 自动化提供程序都能够公开工具提示控件的 TextPattern。

当工具提示控件出现在屏幕上时，必须引发 ToolTipOpenedEvent。该事件将包括对工具提示自身的 UI 自动化元素的引用。

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

UI 自动化事件	支持	说明
TextSelectionChangedEvent	视情况而定	无
TextChangedEvent	视情况而定	无
WindowClosedEvent	视情况而定	无
WindowOpenedEvent	视情况而定	无
TooltipOpenedEvent()	必需的操作	无
TooltipClosedEvent()	必需的操作	无
BoundingRectangleProperty property-changed 事件。	必需的操作	无
IsOffscreenProperty property-changed 事件。	必需的操作	无
IsEnabledProperty property-changed 事件。	必需的操作	无
NameProperty property-changed 事件。	必需的操作	无
WindowVisualStateProperty property-changed 事件。	视情况而定	无
AutomationFocusChangedEvent	必需的操作	无
StructureChangedEvent	必需的操作	无