Benutzeroberflächenautomatisierungs-Unterstützung für den Bild-Steuerelementtyp
Hinweis
Diese Dokumentation ist für .NET Framework-Entwickler konzipiert, die die verwalteten Klassen zur Automatisierung der Benutzeroberfläche verwenden möchten, die im Namespace System.Windows.Automation definiert sind. Aktuelle Informationen zur Automatisierung der Benutzeroberfläche finden Sie auf der Seite zur Windows-Automatisierungs-API: Benutzeroberflächenautomatisierung.
Dieser Artikel enthält Informationen zur Unterstützung der Benutzeroberflächenautomatisierung für den Steuerelementtyp „Image“. Bei der Benutzeroberflächenautomatisierung entspricht ein Steuerelementtyp einer Reihe von Bedingungen, die ein Steuerelement erfüllen muss, um die ControlTypeProperty-Eigenschaft verwendet zu können. Zu den Bedingungen gehören spezifische Richtlinien für die Struktur der Benutzeroberflächenautomatisierung, Eigenschaftswerte der Benutzeroberflächenautomatisierung und Steuerelementmuster.
Als Symbole, Informationsgrafiken und Diagramme verwendete Image-Steuerelemente unterstützen den Steuerelementtyp „Image“. Als Hintergrund- oder Wasserzeichenbilder verwendete Steuerelemente unterstützen den Steuerelementtyp „Image“ nicht.
In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierung, Eigenschaften, Steuerelementmuster und Ereignisse für den Steuerelementtyp „Image“ definiert. Die Anforderungen für die Benutzeroberflächenautomatisierung gelten für alle Image-Steuerelemente, unabhängig davon, ob Windows Presentation Foundation (WPF), Win32 oder Windows Forms verwendet wird.
Erforderliche Benutzeroberflächenautomatisierungs-Struktur
In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung für Image-Steuerelemente sowie die möglichen Inhalte der Ansichten beschrieben. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
| Image | Bild (abhängig davon, ob das Bild Informationen enthält (basierend auf dem Wert der IsContentElement -Eigenschaft)) |
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition für den Image-Steuerelementtyp besonders relevant ist. Weitere Informationen zu den Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Eigenschaften der Benutzeroberflächenautomatisierung 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ßere Rechteck, das das gesamte Steuerelement enthält. |
| ClickablePointProperty | Siehe Hinweise. | Der durch Klicken aktivierbare Punkt des Image-Steuerelements muss ein Punkt innerhalb des umschließenden Rechtecks des Image-Steuerelements sein. |
| IsKeyboardFocusableProperty | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
| NameProperty | Siehe Hinweise. | Die Name-Eigenschaft muss für alle Image-Steuerelemente verfügbar gemacht werden, die Informationen enthalten. Der programmgesteuerte Zugriff auf diese Informationen erfordert, dass eine aus Text bestehende Entsprechung zur Grafik bereitgestellt wird. Wenn das Image-Steuerelement rein dekorativen Zwecken dient, muss es nur in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur angezeigt werden und benötigt daher keinen Namen. Benutzeroberflächenframeworks müssen eine ALT- oder alternative Texteigenschaft für Bilder unterstützen, die innerhalb des Frameworks festgelegt werden kann. Diese Eigenschaft wird dann der Name-Eigenschaft der Benutzeroberflächenautomatisierung zugeordnet. |
| LabeledByProperty | Siehe Hinweise. | Wenn eine statische Textbezeichnung vorhanden ist, muss diese Eigenschaft einen Verweis auf das entsprechende Steuerelement verfügbar machen. |
| ControlTypeProperty | Image | Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
| LocalizedControlTypeProperty | „Bild“ | Lokalisierte Zeichenfolge für den Steuerelementtyp „Image“. |
| IsContentElementProperty | Siehe Hinweise. | Das Image-Steuerelement muss in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten sein, wenn es bedeutsame Informationen enthält, die für den Endbenutzer noch nicht verfügbar gemacht wurden. |
| IsControlElementProperty | True | Das Image-Steuerelement ist stets in der Steuerelementansicht der Struktur der Benutzeroberflächenautomatisierung enthalten. |
| HelpTextProperty | Siehe Hinweise. | Die HelpText-Eigenschaft macht eine lokalisierte Zeichenfolge verfügbar, die die tatsächliche visuelle Darstellung des Steuerelements (z. B. ein rotes Quadrat mit einem weißen „X“) oder andere dem Bild zugeordnete QuickInfo-Informationen beschreibt. Diese Eigenschaft muss unterstützt werden, wenn eine lange Beschreibung erforderlich ist, um weitere Informationen zum Image-Steuerelement zu vermitteln. Beispielsweise eine komplizierte Grafik oder ein Diagramm. Diese Eigenschaft wird dem „LongDesc“-HTML-Tag und dem „Desc“-SVG-Tag (Scalable Vector Graphics) zugeordnet. Mit Image-Steuerelementen arbeitende Entwickler müssen eine Eigenschaft unterstützen, um das Festlegen der visuellen Beschreibung für das Steuerelement zu gestatten. Diese Eigenschaft muss der „VisualDescription“-Eigenschaft der Benutzeroberflächenautomatisierung zugeordnet werden. |
| ItemStatusProperty | Siehe Hinweise. | Wenn das Image-Steuerelement Statusinformationen zu einem bestimmten Element auf dem Bildschirm darstellt, sollte das Steuerelement in diesem Element enthalten sein. Wenn das Bild in einem Element enthalten ist, muss das Element die Status-Eigenschaft unterstützen und entsprechende Benachrichtigungen auslösen, wenn sich der Status ändert. Wenn ein Bild ein eigenständiges Steuerelement ist und den Status übermittelt, muss diese Eigenschaft unterstützt werden. |
Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster
In der folgenden Tabellen sind die Steuerelementmuster der Benutzeroberflächenautomatisierung aufgeführt, die von allen Image-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
| Steuerelementmuster | Support | Hinweise |
|---|---|---|
| IGridItemProvider | Depends (Abhängig) | Das Image-Steuerelement unterstützt das GridItem-Muster, wenn sich das Steuerelement innerhalb eines Rastercontainers befindet. |
| ITableItemProvider | Depends (Abhängig) | Das Image-Steuerelement unterstützt das TableItem-Muster, wenn sich das Steuerelement innerhalb eines Containers befindet, der Header-Steuerelemente aufweist. |
| IInvokeProvider | Nie | Wenn das Image-Steuerelement ein durch Klicken aktivierbares Bild enthält, sollte das Steuerelement einen Steuerelementtyp unterstützen, der das Invoke-Muster unterstützt, z. B. den Steuerelementtyp „Button“. |
| ISelectionItemProvider | Nie | Image-Steuerelemente sollten das SelectionItem-Muster nicht unterstützen. |
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
In der folgenden Tabellen sind die Ereignisse der Benutzeroberflächenautomatisierung aufgeführt, die von allen Image-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Ereignis der Benutzeroberflächenautomatisierung | Support | Hinweise |
|---|---|---|
| InvokedEvent | Nie | Keine |
| ElementAddedToSelectionEvent | Nie | Keine |
| ElementRemovedFromSelectionEvent | Nie | Keine |
| ElementSelectedEvent | Nie | Keine |
| Durch geänderteBoundingRectangleProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| Durch geänderteIsOffscreenProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| Durch geänderteIsEnabledProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| Durch geänderteNameProperty -Eigenschaft ausgelöstes Ereignis. | Erforderlich | Keine |
| AutomationFocusChangedEvent | Erforderlich | Keine |
| StructureChangedEvent | Erforderlich | Keine |