Bildsteuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den steuerelementtyp Image.
Bildsteuerelemente, die als Symbole, Informationsgrafiken und Diagramme verwendet werden, unterstützen den Bild- Steuerelementtyp. Steuerelemente, die als Hintergrund- oder Wasserzeichenbilder verwendet werden, unterstützen nicht den steuerelementtyp Image.
In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Image- Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Bildsteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform die Benutzeroberflächenautomatisierungsunterstützung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält die folgenden Abschnitte.
- typische Strukturstruktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Verwandte Themen
Typische Struktur
Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Bildsteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
| Bild | Bild (Hängt davon ab, ob das Bild Informationen enthält, basierend auf dem Wert der Automation Element Property Identifiers-Eigenschaft) |
Relevante Eigenschaften
In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für die Bildsteuerelemente relevant ist. Weitere Informationen zu Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Abrufen von Eigenschaften aus benutzeroberflächenautomatisierungs-Elementen.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Notizen |
|---|---|---|
| UIA_AutomationIdPropertyId | Siehe Hinweise. | Der Wert dieser Eigenschaft muss zwischen allen Peerelementen in der unformatierten Ansicht der Benutzeroberflächenautomatisierungs-Struktur eindeutig sein. |
| UIA_BoundingRectanglePropertyId | Siehe Hinweise. | Das äußerste Rechteck, das das gesamte Steuerelement enthält. |
| UIA_ClickablePointPropertyId | Siehe Hinweise. | Der klickbare Punkt des Bildsteuerelements muss ein Punkt innerhalb des umgebenden Rechtecks des Bildsteuerelements sein. |
| UIA_ControlTypePropertyId | Bild- | |
| UIA_HelpTextPropertyId | Siehe Hinweise. | Die HelpText--Eigenschaft macht eine lokalisierte Zeichenfolge verfügbar, die die tatsächliche visuelle Darstellung des Steuerelements oder anderer QuickInfo-Informationen beschreibt, die dem Bild zugeordnet sind. Diese Eigenschaft muss unterstützt werden, wenn eine lange Beschreibung erforderlich ist, um weitere Informationen zum Bildsteuerelement zu vermitteln (z. B. wenn das Bild ein kompliziertes Diagramm oder Diagramm ist). Diese Eigenschaft ist dem HTML-LongDesc Tag und dem SVG-Tag (Scalable Vector Graphics) Desc Tag zugeordnet. Entwickler, die mit Bildsteuerelementen arbeiten, müssen eine Eigenschaft unterstützen, damit die visuelle Beschreibung für das Steuerelement festgelegt werden kann. Diese Eigenschaft muss der -Eigenschaft der Benutzeroberflächenautomatisierung VisualDescription zugeordnet werden. |
| UIA_IsContentElementPropertyId | Siehe Hinweise. | Das Bildsteuerelement muss in die Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur einbezogen werden, wenn es aussagekräftige Informationen enthält, die nicht bereits für den Endbenutzer verfügbar gemacht werden. |
| UIA_IsControlElementPropertyId | STIMMT | Das Bildsteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten. |
| UIA_IsKeyboardFocusablePropertyId | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
| UIA_ItemStatusPropertyId | Siehe Hinweise. | Wenn das Bildsteuerelement Statusinformationen zu einem bestimmten Element auf dem Bildschirm darstellt, sollte das Steuerelement im Element enthalten sein. Wenn das Bild in einem Element enthalten ist, muss das Element die Statuseigenschaft unterstützen und entsprechende Benachrichtigungen auslösen, wenn sich der Status ändert. Wenn ein Bild ein eigenständiges Steuerelement ist und den Status dieser Eigenschaft vermittelt, muss diese Eigenschaft unterstützt werden. |
| UIA_LabeledByPropertyId | Siehe Hinweise. | Wenn eine statische Beschriftung vorhanden ist, muss diese Eigenschaft einen Verweis auf dieses Steuerelement verfügbar machen. |
| UIA_LocalizedControlTypePropertyId | Siehe Hinweise. | Lokalisierte Zeichenfolge, die dem steuerelementtyp Image entspricht. Der Standardwert ist "image" für en-US oder Englisch (USA). |
| UIA_NamePropertyId | Siehe Hinweise. | Die eigenschaft Name muss für alle Bildsteuerelemente verfügbar gemacht werden, die Informationen enthalten. Der programmgesteuerte Zugriff auf diese Informationen erfordert, dass eine textbezogene Entsprechung zur Grafik bereitgestellt wird. Wenn das Bildsteuerelement rein dekorativ ist, darf es nur in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur angezeigt werden und muss keinen Namen haben (siehe Hinweise). Benutzeroberflächenframeworks müssen eine ALT- oder alternative Texteigenschaft für Bilder unterstützen, die innerhalb ihres Frameworks festgelegt werden können. Diese Eigenschaft wird dann der Name-Eigenschaft der Benutzeroberflächenautomatisierung zugeordnet. |
Erforderliche Steuerelementmuster
In der folgenden Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die für Bildsteuerelemente unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.
| Steuerelementmuster | Unterstützen | Notizen |
|---|---|---|
| IGridItemProvider- | Hängt | Das Bildsteuerelement unterstützt das GridItem- Steuerelementmuster, wenn sich das Steuerelement in einem Rastercontainer befindet. |
| IInvokeProvider- | Nie | Wenn das Bildsteuerelement ein klickbares Objekt ist, sollte das Steuerelement einen Steuerelementtyp unterstützen, der das Invoke-Steuerelementmuster unterstützt, z. B. den Steuerelementtyp Button. Für ein Bildobjekt, das mehrere klickbare Objekte enthält, kann das Element (Bildsteuerelementtyp) untergeordnete Links (Hyperlink--Steuerelementtyp) in der Benutzeroberflächenautomatisierungs-Struktur hosten. |
| ISelectionItemProvider- | Nie | Bildsteuerelemente sollten das SelectionItem- Steuerelementmuster nicht unterstützen. Wenn Bilder Teil eines Containers sind, der auswählbar ist, z. B. eine Schaltfläche mit einem Bildsymbol als Inhalt, unterstützt dieser Container das Muster und nicht das Bild innerhalb. |
| ITableItemProvider- | Hängt | Das Bildsteuerelement unterstützt das TableItem- Steuerelementmusters, wenn sich das Steuerelement in einem Container mit Kopfzeilensteuerelementen befindet. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungsereignisse aufgeführt, die für die Unterstützung von Bildsteuerelementen erforderlich sind. Weitere Informationen zu Ereignissen finden Sie unter Ui Automation Events Overview.
| Benutzeroberflächenautomatisierungs-Ereignis | Notizen |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId Eigenschaftsänderungsereignis. | |
| UIA_IsEnabledPropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement die IsEnabled--Eigenschaft unterstützt, muss dieses Ereignis unterstützt werden. |
| UIA_IsOffscreenPropertyId Ereignis mit Eigenschaftsänderung. | Wenn das Steuerelement die IsOffscreen--Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_ItemStatusPropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement die ItemStatus--Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_NamePropertyId Eigenschaftsänderungsereignis. | |
| UIA_StructureChangedEventId |
Bemerkungen
Das World Wide Web Consortium (W3C) definiert ein dekoratives Bild als ein Bild, das dem Inhalt einer Seite keine Informationen hinzugibt. Weitere Details finden Sie im W3C-Thema zu dekorativen Bildern.
Im Hinblick auf die Benutzeroberflächenautomatisierung:
- Wenn ein Bild rein dekorativ ist, nicht interaktiv ist und keine Informationen vermittelt, wird das Bild:
- Möglicherweise befindet sich die UIA-Struktur oder nicht
- Möglicherweise befindet sich die unformatierte UIA-Ansicht.
- Darf nicht in der UIA-Steuerelementansicht sein
- Darf nicht in der Inhaltsansicht enthalten sein
- Möglicherweise oder nicht über einen Namen
- Wenn ein Bild Informationen vermittelt, aber eindeutig zugeordneter Text vorhanden ist, der dieselben Informationen bereitstellt (z. B. eine Wiedergabeschaltfläche, die eine Dreieckgrafik mit linkszeigen Zeiger zusammen mit dem Text "Wiedergeben") enthält, wird das Bild als dekorativ betrachtet und das Bild:
- Muss sich in der unformatierten Ansicht befinden
- Muss sich in der Steuerelementansicht befinden
- Darf nicht in der Inhaltsansicht enthalten sein
- Möglicherweise oder nicht über einen Wert in der Name-Eigenschaft
- Der Text, der auch die Bedeutung des Bilds vermittelt, muss sich in der Inhaltsansicht befinden.
- Wenn ein Bild informativ ist und Details vermittelt, die von keinem zugeordneten Text bereitgestellt werden, wird das Bild:
- Muss sich in der unformatierten Ansicht befinden
- Muss sich in der Steuerelementansicht befinden
- Muss sich in der Inhaltsansicht befinden
- Muss einen Namenswert aufweisen, der das Bild und seine Bedeutung beschreibt