Freigeben über


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

Siehe auch