QuickInfo-Steuerelementtyp

Dieses Thema enthält Informationen zu Microsoft Benutzeroberflächenautomatisierung Unterstützung für den ToolTip-Steuerelementtyp. QuickInfo-Steuerelemente sind Popupfenster, die Text enthalten.

In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den ToolTip-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle QuickInfo-Steuerelemente, bei denen das Benutzeroberflächenframework bzw. die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält folgende Abschnitte:

Typische Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur, die sich auf QuickInfo-Steuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierung-Struktur finden Sie unter übersicht über Benutzeroberflächenautomatisierung-Struktur.

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

QuickInfo-Steuerelemente werden nur in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur angezeigt, wenn sie den Tastaturfokus erhalten können. Andernfalls sind alle Informationen der QuickInfo über die IUIAutomationElement::CurrentHelpText -Eigenschaft (oder CachedHelpText) für das Element verfügbar, auf das die QuickInfo verweist.

QuickInfos sollten unter dem Steuerelement angezeigt werden, auf das ihre Informationen verweisen. Clients müssen auf die UIA _ ToolTipOpenedEventId lauschen, um sicherzustellen, dass sie die in QuickInfos enthaltenen Informationen konsistent abrufen.

Relevante Eigenschaften

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition für den ToolTip-Steuerelementtyp besonders relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Notizen
UIA _ AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss für alle Peerelemente in der rohen Ansicht der Benutzeroberflächenautomatisierung-Struktur eindeutig sein.
UIA _ BoundingRectanglePropertyId Siehe Hinweise. Das äußere Rechteck, das das gesamte Steuerelement enthält.
UIA _ ClickablePointPropertyId Siehe Hinweise. Der klickbare Punkt sollte teil der QuickInfo sein, mit der das Steuerelement verworfen wird. Einige QuickInfos haben diese Möglichkeit nicht und verfügen nicht über einen klickbaren Punkt.
UIA _ ControlTypePropertyId ToolTip
UIA _ IsContentElementPropertyId Depends (Abhängig) Wenn das QuickInfo-Steuerelement den Tastaturfokus erhalten kann, muss es in der Inhaltsansicht der Struktur angezeigt werden. Wenn es sich nur um Text handelt, ist er als IUIAutomationElement::CurrentHelpText (oder CachedHelpText )-Eigenschaftdes Steuerelements verfügbar, das es ausgelöst hat.
UIA _ IsControlElementPropertyId True Das QuickInfo-Steuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierung-Struktur enthalten.
UIA _ IsKeyboardFocusablePropertyId Siehe Hinweise. Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
UIA _ LabeledByPropertyId NULL QuickInfo-Steuerelemente werden immer durch ihren Inhalt selbstbeschriftet.
UIA _ LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge für den Steuerelementtyp „ToolTip“. Der Standardwert ist "quicktip" für en-US oder Englisch (USA).
_UIA-NamePropertyId Siehe Hinweise. Der Name des QuickInfo-Steuerelements ist der Text, der in der QuickInfo angezeigt wird.

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Steuerelementmuster aufgeführt, die von QuickInfo-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.

Steuerelementmuster Support Notizen
ITextProvider Depends (Abhängig) Zur Verbesserung der Barrierefreiheit kann ein QuickInfo-Steuerelement das Text-Steuerelementmuster unterstützen, obwohl es nicht erforderlich ist. Das Text-Steuerelementmuster ist nützlich, wenn der Text viele Formate und Attribute hat (z. B., Farbe, Fettdruck und Kursivdruck).
IWindowProvider Depends (Abhängig) QuickInfos, die durch Klicken auf ein Benutzeroberflächenelement geschlossen werden können, müssen das Fenster-Steuerelementmuster unterstützen, damit sie automatisch geschlossen werden können.

Erforderliche Ereignisse

QuickInfo-Steuerelemente müssen das UIA _ ToolTipOpenedEventId-Ereignis auslösen, wenn sie auf dem Bildschirm angezeigt werden. Das Ereignis enthält einen Verweis auf das Benutzeroberflächenautomatisierung Element der QuickInfo selbst.

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die QuickInfo-Steuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.

Benutzeroberflächenautomatisierung-Ereignis Notizen
UIA _ AutomationFocusChangedEventId
UIA _ Das BoundingRectanglePropertyId-Eigenschaftswechselereignis.
UIA _ Das IsEnabledPropertyId-Eigenschaftswechselereignis. Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA _ IsOffscreenPropertyId-Eigenschaftswechselereignis. Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA _ Das NamePropertyId-Eigenschaftswechselereignis.
UIA _ Text _ TextChangedEventId Wenn das Steuerelement das Text-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA _ ToolTipClosedEventId
UIA _ ToolTipOpenedEventId
UIA _ StructureChangedEventId
_ _ UIA-FensterFensterClosedEventId Wenn das Steuerelement das Window-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
_ _ UIA-FensterOpenedEventId Wenn das Steuerelement das Window-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA _ WindowWindowVisualStatePropertyId-Eigenschaftswechselereignis. Wenn das Steuerelement das Window-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung