Freigeben über

QuickInfo-Steuerelementtyp

  • Artikel

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

In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den QuickInfo- Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle QuickInfo-Steuerelemente, bei denen das Benutzeroberflächenframework/die Plattform die Benutzeroberflächenautomatisierungsunterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält die folgenden Abschnitte.

Typische Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf QuickInfo-Steuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.

Steuerelementansicht Inhaltsansicht
  • Quickinfo
    • Text (0 oder mehr)
    • Bild (0 oder mehr)
  • Quickinfo

 

QuickInfo-Steuerelemente werden nur in der Inhaltsansicht der Benutzeroberflächenautomatisierungsstruktur angezeigt, wenn sie den Tastaturfokus erhalten können. Andernfalls stehen alle QuickInfo-Informationen aus dem IUIAutomationElement::CurrentHelpText (oder CachedHelpText) -Eigenschaft für das Element zur Verfügung, auf das die QuickInfo verweist.

QuickInfos sollten unterhalb des Steuerelements angezeigt werden, auf das ihre Informationen verweisen. Clients müssen auf die UIA_ToolTipOpenedEventId lauschen, um sicherzustellen, dass sie konsistente Informationen erhalten, die in QuickInfos enthalten sind.

Relevante Eigenschaften

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

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Notizen
UIA_AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss zwischen allen Peerelementen in der unformatierten Ansicht der Benutzeroberflächenautomatisierungs-Struktur eindeutig sein.
UIA_BoundingRectanglePropertyId Siehe Hinweise. Das äußerste Rechteck, das das gesamte Steuerelement enthält.
UIA_ClickablePointPropertyId Siehe Hinweise. Der klickbare Punkt sollte teil der QuickInfo sein, die das Steuerelement schließt. Einige QuickInfos haben diese Möglichkeit nicht und weisen keinen klickbaren Punkt auf.
UIA_ControlTypePropertyId QuickInfo-
UIA_IsContentElementPropertyId Hängt 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 es als IUIAutomationElement::CurrentHelpText (oder CachedHelpText) -Eigenschaft des Steuerelements verfügbar, das es ausgelöst hat.
UIA_IsControlElementPropertyId STIMMT Das QuickInfo-Steuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-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 selbstbeschriftet durch ihre Inhalte.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem QuickInfo-Steuerelementtyp entspricht. 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 Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von QuickInfo-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.

Steuerelementmuster Unterstützen Notizen
ITextProvider- Hängt 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 umfangreiche Formatvorlagen und Attribute aufweist (z. B. Farbe, Fett und Kursiv).
IWindowProvider- Hängt QuickInfos, die durch Klicken auf ein UI-Element geschlossen werden können, müssen das Window 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ächenautomatisierungs-Element der QuickInfo selbst.

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

Benutzeroberflächenautomatisierungs-Ereignis Notizen
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaftsänderungsereignis.
UIA_IsEnabledPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsEnabled--Eigenschaft unterstützt, muss dieses Ereignis unterstützt werden.
UIA_IsOffscreenPropertyId Ereignis mit Eigenschaftsänderung. 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- Steuerelementmusters 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.

 

Konzeptionelle

Übersicht über Steuerelementtypen für die Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung