Benutzeroberflächenautomatisierungs-Unterstützung für den Bild-Steuerelementtyp

Hinweis
Diese Dokumentation ist für .NET Framework-Entwickler vorgesehen, die die verwalteten UI Automation-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind.Aktuelle Informationen zu UI Automation finden Sie unter Windows Automation API: UI Automation.

Dieses Thema enthält Informationen zur UI Automation-Unterstützung für den Image-Steuerelementtyp. In der UI Automation umfasst ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlTypeProperty-Eigenschaft verwendet werden kann. Die Bedingungen schließen bestimmte Richtlinien für UI Automation-Struktur, UI Automation-Eigenschaftswerte und Steuerelementmuster ein.

Image-Steuerelemente, die als Symbole, Informationsgrafiken und Diagramme verwendet werden, unterstützen den Image-Steuerelementtyp. Als Hintergrund oder Wasserzeichen verwendete Bilder unterstützen den Image-Steuerelementtyp nicht.

In den folgenden Abschnitten werden die UI Automation-Struktur, Eigenschaften, Steuerelementmuster und Ereignisse definiert, die für den Image-Steuerelementtyp erforderlich sind. Die UI Automation-Anforderungen gelten für alle Image-Steuerelemente, seien dies Windows Presentation Foundation (WPF)-, Win32- oder Windows Forms-Steuerelemente.

Dieses Thema enthält folgende Abschnitte.

• Erforderliche Benutzeroberflächenautomatisierungs-Struktur
• Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
• Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung
• Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
• Verwandte Abschnitte

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI Automation-Struktur für Image-Steuerelemente beschrieben sowie der Inhalt der einzelnen Ansichten erläutert. Weitere Informationen über die UI Automation-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht	Inhaltsansicht
Bild	Bild (Abhängig davon, ob das Bild Informationen enthält (auf Grundlage des Werts der IsContentElement-Eigenschaft))

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle sind die UI Automation-Eigenschaften aufgelistet, deren Werte oder Definitionen für den Image-Steuerelementtyp besonders relevant sind. Weitere Informationen über UI Automation-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.

UI Automation-Eigenschaft	Wert	Hinweise
AutomationIdProperty	Siehe Hinweise.	Der Wert dieser Eigenschaft muss für alle Steuerelemente einer Anwendung eindeutig sein.
BoundingRectangleProperty	Siehe Hinweise.	Das äußere, das gesamte Steuerelement umfassende Rechteck.
ClickablePointProperty	Siehe Hinweise.	Der klickbare 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. Für den programmgesteuerten Zugriff auf diese Informationen ist erforderlich, dass eine Textentsprechung zur Grafik bereitgestellt wird. Wenn das Image-Steuerelement rein dekorativen Zwecken dient, muss es nur in der Steuerelementansicht der UI Automation-Struktur angezeigt werden und muss keinen Namen haben. Benutzeroberflächen-Frameworks müssen für Bilder eine Eigenschaft für einen Alternativtext (ALT) unterstützen, die im Framework festgelegt werden kann. Diese Eigenschaft wird dann der UI Automation-Name-Eigenschaft zugeordnet.
LabeledByProperty	Siehe Hinweise.	Wenn eine statische Textbezeichnung vorhanden ist, muss diese Eigenschaft einen Verweis auf das entsprechende Steuerelement verfügbar machen.
ControlTypeProperty	Bild	Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.
LocalizedControlTypeProperty	"Bild"	Lokalisierte Zeichenfolge für den Image-Steuerelementtyp.
IsContentElementProperty	Siehe Hinweise.	Das Image-Steuerelement muss in der Inhaltsansicht der UI Automation-Struktur enthalten sein, wenn es relevante Informationen enthält, die dem Endbenutzer noch nicht verfügbar gemacht wurden.
IsControlElementProperty	True	Das Image-Steuerelement ist in der Steuerelementansicht der UI Automation-Struktur immer enthalten.
HelpTextProperty	Siehe Hinweise.	Die HelpText-Eigenschaft macht eine lokalisierte Zeichenfolge verfügbar, die die tatsächliche visuelle Darstellung des Steuerelements (z. B. "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 über das Image-Steuerelement anzuzeigen. Beispielsweise für ein komplexes Diagramm. Diese Eigenschaft wird dem HTML-Tag LongDesc tag und dem SVG-Tag (Scalable Vector Graphics) Desc zugeordnet. Mit Image-Steuerelementen arbeitende Entwickler müssen eine Eigenschaft unterstützen, die es ermöglicht, die visuelle Beschreibung für das Steuerelement festzulegen. Diese Eigenschaft muss der Benutzeroberflächenautomatisierungs-Eigenschaft VisualDescription zugeordnet werden.
ItemStatusProperty	Siehe Hinweise.	Wenn das Image-Steuerelement Statusinformationen über ein bestimmtes 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 Statuseigenschaft unterstützen und bei Statusänderungen entsprechende Benachrichtigungen auslösen. Wenn ein Bild ein eigenständiges Steuerelement ist, das den Status übergibt, muss diese Eigenschaft unterstützt werden.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

In der folgenden Tabelle sind die UI Automation-Steuerelementmuster aufgelistet, die von allen Image-Steuerelementen unterstützt werden müssen. Weitere Informationen über Steuerelementmuster finden Sie unter Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung.

Steuerelementmuster	Unterstützung	Hinweise
IGridItemProvider	Variabel	Das Image-Steuerelement unterstützt das GridItem-Muster, wenn sich das Steuerelement innerhalb eines Rastercontainers befindet.
ITableItemProvider	Variabel	Das Image-Steuerelement unterstützt das TableItem-Muster, wenn sich das Steuerelement innerhalb eines Containers mit Header-Steuerelementen befindet.
IInvokeProvider	Nie	Wenn das Image-Steuerelement ein klickbares Bild enthält, sollte es einen Steuerelementtyp unterstützen, der das Invoke-Muster unterstützt, z. B. den Button-Steuerelementtyp.
ISelectionItemProvider	Nie	Image-Steuerelemente sollten das SelectionItem-Muster nicht unterstützen.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

In der folgenden Tabelle sind die UI Automation-Ereignisse aufgelistet, die von allen Image-Steuerelementen unterstützt werden müssen. Weitere Informationen über Ereignisse finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.

UI Automation-Ereignis	Unterstützung	Hinweise
InvokedEvent	Nie	Keine
ElementAddedToSelectionEvent	Nie	Keine
ElementRemovedFromSelectionEvent	Nie	Keine
ElementSelectedEvent	Nie	Keine
Durch geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
Durch geänderte NameProperty-Eigenschaft ausgelöstes Ereignis	Erforderlich	Keine
AutomationFocusChangedEvent	Erforderlich	Keine
StructureChangedEvent	Erforderlich	Keine

Siehe auch

Referenz

Image

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung