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
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Zugehörige Themen
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 |
|---|---|
|
|
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.