Freigeben über

QuickInfo-Steuerelementtyp

  • Artikel

Dieses Thema enthält Informationen zur Unterstützung des QuickInfo-Steuerelementtyps von Microsoft Benutzeroberflächenautomatisierung. QuickInfo-Steuerelemente sind Popupfenster, die Text enthalten.

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

Dieses Thema enthält folgende Abschnitte:

Typische Struktur der 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 Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.

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 sich ihre Informationen beziehen. Clients müssen auf die UIA_ToolTipOpenedEventId lauschen, um sicherzustellen, dass die in QuickInfos enthaltenen Informationen konsistent abgerufen werden.

Relevante Eigenschaften

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition für den QuickInfo-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 Rohansicht 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 der Teil der QuickInfo sein, der das Steuerelement verwirf. Einige QuickInfos verfügen nicht über diese Möglichkeit 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-Eigenschaft (oder CachedHelpText) des Steuerelements verfügbar, das ihn 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 "QuickInfo" 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) Für eine bessere 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 Ui-Element 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 von QuickInfo-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.

Ereignis der Benutzeroberflächenautomatisierung Notizen
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaftsänderungsereignis.
UIA_IsEnabledPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_IsOffscreenPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_NamePropertyId Eigenschaftsänderungsereignis.
UIA_Text_TextChangedEventId Wenn das Steuerelement das Text-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ToolTipClosedEventId
UIA_ToolTipOpenedEventId
UIA_StructureChangedEventId
UIA_Window_WindowClosedEventId Wenn das Steuerelement das Window-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_Window_WindowOpenedEventId Wenn das Steuerelement das Window-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_WindowWindowVisualStatePropertyId Eigenschaftsänderungsereignis. 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