Benutzeroberflächenautomatisierungs-Unterstützung für den ToolTip-Steuerelementtyp

Hinweis
Diese Dokumentation ist für .NET Framework-Entwickler vorgesehen, die die verwalteten UI Automation-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind.Aktuelle Informationen zu UI Automation finden Sie unter Windows Automation API: UI Automation.

Dieses Thema enthält Informationen über die UI Automation-Unterstützung für den ToolTip-Steuerelementtyp. Bei der UI Automation umfasst ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlTypeProperty-Eigenschaft verwendet werden kann. Die Bedingungen schließen bestimmte Richtlinien für UI Automation-Struktur, UI Automation-Eigenschaftswerte und Steuerelementmuster ein.

ToolTip-Steuerelemente sind Popupfenster, die Text enthalten.

In den folgenden Abschnitten werden die erforderliche UI Automation-Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den ToolTip-Steuerelementtyp definiert. Die UI Automation-Anforderungen gelten für alle ToolTip-Steuerelemente aus Windows Presentation Foundation (WPF), Win32 oder Windows Forms.

Dieses Thema enthält folgende Abschnitte.

• Erforderliche Benutzeroberflächenautomatisierungs-Struktur
• Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
• Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung
• Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
• Verwandte Abschnitte

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI Automation-Struktur, die sich auf ToolTip-Steuerelemente bezieht, dargestellt und die möglichen Inhalte jeder Ansicht beschrieben. Weitere Informationen über die UI Automation-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht	Inhaltsansicht
ToolTip Text (beliebige Anzahl) Bild (beliebige Anzahl)	ToolTip

ToolTip-Steuerelemente werden nur dann in der Inhaltsansicht der UI Automation-Struktur angezeigt, wenn sie den Tastaturfokus erhalten können. Andernfalls sind alle Informationen zur QuickInfo in der HelpTextProperty für das UI Automation-Element verfügbar, auf das die QuickInfo verweist.

QuickInfos werden unter dem Steuerelement angezeigt, auf das ihre Informationen verweisen. Clients müssen das ToolTipOpenedEvent überwachen, um sicherzustellen, dass sie fortlaufend die in QuickInfos enthaltenen Informationen erhalten.

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle werden die UI Automation-Eigenschaften aufgelistet, deren Wert oder Definition für ToolTip-Steuerelemente besonders relevant ist. Weitere Informationen über UI Automation-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.

UI Automation-Eigenschaft	Wert	Hinweise
AutomationIdProperty	Siehe Hinweise.	Der Wert dieser Eigenschaft muss für alle Steuerelemente einer Anwendung eindeutig sein.
BoundingRectangleProperty	Siehe Hinweise.	Das äußere Rechteck, welches das gesamte Steuerelement umfasst.
ClickablePointProperty	Siehe Hinweise.	Der klickbare Punkt muss Teil der QuickInfo sein, die das Steuerelement schließt. Einige QuickInfos besitzen diese Fähigkeit nicht und haben keinen klickbaren Punkt.
IsKeyboardFocusableProperty	Siehe Hinweise.	Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
NameProperty	Siehe Hinweise.	Der Name des ToolTip-Steuerelements ist der Text, der innerhalb der QuickInfo angezeigt wird.
LabeledByProperty	Null	ToolTip-Steuerelemente haben aufgrund ihres Inhalts eine Eigenbezeichnung.
ControlTypeProperty	ToolTip	Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.
LocalizedControlTypeProperty	"tool tip"	Lokalisierte Zeichenfolge, die dem ToolTip-Steuerelementtyp entspricht.
IsContentElementProperty	Variabel	Wenn das ToolTip-Steuerelement den Tastaturfokus erhalten kann, muss es in der Inhaltsansicht der Struktur angezeigt werden. Wenn es sich nur um Text handelt, steht es als HelpTextProperty des Steuerelements zur Verfügung, das es ausgelöst hat.
IsControlElementProperty	True	Das ToolTip-Steuerelement muss immer ein Steuerelement sein.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

In der folgenden Tabelle werden die UI Automation-Steuerelementmuster aufgelistet, die von den ToolTip-Steuerelementen unterstützt werden müssen. Weitere Informationen über Steuerelementmuster finden Sie unter Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung.

Steuerelementmuster	Unterstützung	Hinweise
IWindowProvider	Variabel	QuickInfos, die durch Klicken auf ein Benutzeroberflächenelement geschlossen werden können, müssen WindowPattern unterstützen, damit sie automatisch geschlossen werden können.
ITextProvider	Variabel	Für eine verbesserte Barrierefreiheit kann ein QuickInfo-Steuerelement das Text-Steuerelementmuster unterstützen, dies ist jedoch nicht erforderlich. Das Text-Steuerelementmuster ist nützlich, wenn der Text komplex formatiert ist und viele Attribute aufweist (z. B., Farbe, Fettdruck und Kursivdruck).

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

ToolTip-Steuerelemente müssen ToolTipOpenedEvent auslösen, wenn sie auf dem Bildschirm angezeigt werden. Das Ereignis schließt einen Verweis auf das UI Automation-Element der QuickInfo selbst ein.

In der folgenden Tabelle sind die UI Automation-Ereignisse aufgelistet, die von allen ToolTip-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.

UI Automation-Ereignis	Unterstützung	Hinweise
TextSelectionChangedEvent	Variabel	Keine
TextChangedEvent	Variabel	Keine
WindowClosedEvent	Variabel	Keine
WindowOpenedEvent	Variabel	Keine
ToolTipOpenedEvent	Erforderlich	Keine
ToolTipClosedEvent	Erforderlich	Keine
Durch geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte NameProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte WindowVisualStateProperty-Eigenschaft ausgelöstes Ereignis	Variabel	Keine
AutomationFocusChangedEvent	Erforderlich	Keine
StructureChangedEvent	Erforderlich	Keine

Siehe auch

Referenz

ToolTip

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung