Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Hinweis
Diese Dokumentation richtet sich an .NET Framework-Entwickler, die die verwalteten Benutzeroberflächenautomatisierungs-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind. Die neuesten Informationen zur Benutzeroberflächenautomatisierung finden Sie unter Windows Automation API: Benutzeroberflächenautomatisierung.
Dieser Artikel enthält Informationen zur Unterstützung der Benutzeroberflächenautomatisierung für den Steuerelementtyp „QuickInfo“. Bei der Benutzeroberflächenautomatisierung ist ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, um die ControlTypeProperty Eigenschaft verwenden zu können. Zu den Bedingungen gehören spezifische Richtlinien für die Baumstruktur der UI Automation, Eigenschaftswerte der UI Automation und Steuermuster.
QuickInfo-Steuerelemente sind Popupfenster, die Text enthalten.
In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierung, Eigenschaften, Steuerelementmuster und Ereignisse für den Steuerelementtyp „QuickInfo“ definiert. Die Anforderungen für die Benutzeroberflächenautomatisierung gelten für alle QuickInfo-Steuerelemente, unabhängig davon, ob Windows Presentation Foundation (WPF), Win32 oder Windows Forms verwendet wird.
Erforderliche UI-Automatisierungsbaumstruktur
In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung für QuickInfo-Steuerelemente sowie die möglichen Inhalte der Ansichten beschrieben. Weitere Informationen zur Benutzeroberflächenautomatisierungs-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungsstruktur.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
| Tooltip - Text (0 oder mehr) - Bild (0 oder mehr) |
Tooltip |
QuickInfo-Steuerelemente werden nur dann in der Inhaltsansicht der Benutzeroberflächenautomatisierungsstruktur angezeigt, wenn sie den Tastaturfokus erhalten können. Andernfalls sind alle Informationen zur QuickInfo über die HelpTextProperty für das Benutzeroberflächenautomatisierungselement verfügbar, auf das die QuickInfo verweist.
QuickInfos sollten unter dem Steuerelement angezeigt werden, auf das sich ihre Informationen beziehen. Clients müssen dem ToolTipOpenedEvent lauschen, um sicherzustellen, dass sie fortlaufend die in QuickInfos enthaltenen Informationen erhalten.
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für Tooltip-Steuerelemente relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierungs-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungseigenschaften für Clients.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Hinweise |
|---|---|---|
| AutomationIdProperty | Siehe Hinweise. | Der Wert dieser Eigenschaft muss für alle Steuerelemente in einer Anwendung eindeutig sein. |
| BoundingRectangleProperty | Siehe Hinweise. | Das äußerste Rechteck, das das gesamte Steuerelement enthält. |
| ClickablePointProperty | Siehe Hinweise. | Der klickbare Punkt muss Teil der QuickInfo sein, die das Steuerelement schließt. Einige Tooltips haben diese Fähigkeit nicht und besitzen 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 QuickInfo-Steuerelements ist der Text, der innerhalb der QuickInfo angezeigt wird. |
| LabeledByProperty | Null |
QuickInfo-Steuerelemente werden immer durch ihren Inhalt selbstbeschriftet. |
| ControlTypeProperty | Tooltip | Dieser Wert ist für alle Benutzeroberflächenframeworks identisch. |
| LocalizedControlTypeProperty | „QuickInfo“ | Lokalisierte Zeichenfolge, die dem QuickInfo-Steuerelementtyp entspricht. |
| IsContentElementProperty | Hängt | Wenn das QuickInfo-Steuerelement den Tastaturfokus erhalten kann, muss es in der Inhaltsansicht der Struktur enthalten sein. Wenn es sich nur um Text handelt, steht sie als HelpTextProperty aus dem Steuerelement zur Verfügung, das ihn ausgelöst hat. |
| IsControlElementProperty | Richtig | Das QuickInfo-Steuerelement muss immer ein Steuerelement sein. |
Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster
In der folgenden Tabellen sind die Steuerelementmuster der 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ützung | Hinweise |
|---|---|---|
| IWindowProvider | Hängt | 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 | Hängt | Für eine verbesserte Barrierefreiheit kann ein QuickInfo-Steuerelement das Text-Steuerelementmuster unterstützen, dies ist jedoch nicht erforderlich. Das Text-Steuerelementmuster ist nützlich, wenn der Text umfangreiche Formatvorlagen und Attribute aufweist (z. B. Farbe, Fett und Kursiv). |
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
QuickInfo-Steuerelemente müssen ToolTipOpenedEvent auslösen, wenn sie auf dem Bildschirm angezeigt werden. Das Ereignis enthält einen Verweis auf das UI-Automatisierungselement des Tool-Tips selbst.
In der folgenden Tabelle sind die Ereignisse der Benutzeroberflächenautomatisierung aufgeführt, die von allen ToolTip-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter "Übersicht über Benutzeroberflächenautomatisierungsereignisse".
| Benutzeroberflächenautomatisierungs-Ereignis | Unterstützung | Hinweise |
|---|---|---|
| TextSelectionChangedEvent | Hängt | Nichts |
| TextChangedEvent | Hängt | Nichts |
| WindowClosedEvent | Hängt | Nichts |
| WindowOpenedEvent | Hängt | Nichts |
| ToolTipOpenedEvent | Erforderlich | Nichts |
| ToolTipClosedEvent | Erforderlich | Nichts |
| Durch die BoundingRectangleProperty-Eigenschaft geändertes Ereignis. | Erforderlich | Nichts |
| Durch die IsOffscreenProperty-Eigenschaft geändertes Ereignis. | Erforderlich | Nichts |
| Durch die IsEnabledProperty-Eigenschaft geändertes Ereignis. | Erforderlich | Nichts |
| Durch die NameProperty-Eigenschaft geändertes Ereignis. | Erforderlich | Nichts |
| Durch die WindowVisualStateProperty-Eigenschaft geändertes Ereignis. | Hängt | Nichts |
| AutomationFocusChangedEvent | Erforderlich | Nichts |
| StructureChangedEvent | Erforderlich | Nichts |