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

Aktualisiert: November 2007

Dieses Thema enthält Informationen über die UI-Automatisierung-Unterstützung für den ToolTip-Steuerelementtyp. Bei der UI-Automatisierung 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-Automatisierung-Struktur, UI-Automatisierung-Eigenschaftenwerte und Steuerelementmuster ein.

ToolTip-Steuerelemente sind Popupfenster, die Text enthalten.

In den folgenden Abschnitten werden die erforderliche UI-Automatisierung-Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den ToolTip-Steuerelementtyp definiert. Die UI-Automatisierung-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-Automatisierung-Struktur, die sich auf ToolTip-Steuerelemente bezieht, dargestellt und die möglichen Inhalte jeder Ansicht beschrieben. Weitere Informationen über die UI-Automatisierung-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht

Inhaltsansicht

  • ToolTip

  • Text (0 oder 1)

  • Bild (0 oder 1)

  • ToolTip

ToolTip-Steuerelemente werden nur dann in der Inhaltsansicht der UI-Automatisierung-Struktur angezeigt, wenn sie den Tastaturfokus erhalten können. Andernfalls sind alle Informationen zur QuickInfo in der HelpTextProperty für das UI-Automatisierung-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-Automatisierung-Eigenschaften aufgelistet, deren Wert oder Definition für ToolTip-Steuerelemente besonders relevant ist. Weitere Informationen über UI-Automatisierung-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.

UI-Automatisierung-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.

HelpTextProperty

Null

Die HelpText-Eigenschaft ist für ein ToolTip-Steuerelement immer null.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

In der folgenden Tabelle werden die UI-Automatisierung-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/Mustereigenschaft

Unterstützung/Wert

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

Nicht alle Benutzeroberflächenautomatisierungs-Anbieter können TextPattern für ToolTip-Steuerelemente verfügbar machen.

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-Automatisierung-Element der QuickInfo selbst ein.

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

UI-Automatisierung-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 Eigenschaft ausgelöstes BoundingRectangleProperty-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 Eigenschaft ausgelöstes NameProperty-Ereignis.

Erforderlich

Keine

Durch geänderte Eigenschaft ausgelöstes WindowVisualStateProperty-Ereignis.

Variabel

Keine

AutomationFocusChangedEvent

Erforderlich

Keine

StructureChangedEvent

Erforderlich

Keine

Siehe auch

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung

Referenz

ToolTip