Bildsteuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung des Image-Steuerelementtyps von Microsoft Benutzeroberflächenautomatisierung.
Bildsteuerelemente, die als Symbole, Informationsgrafiken und Diagramme verwendet werden, unterstützen den Image-Steuerelementtyp . Steuerelemente, die als Hintergrund- oder Wasserzeichenbilder verwendet werden, unterstützen den Image-Steuerelementtyp nicht.
In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Image-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Bildsteuerelemente, bei denen das Ui-Framework/die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält folgende Abschnitte:
- Typische Struktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Zugehörige Themen
Typische Struktur
Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Bildsteuerelemente bezieht, und beschreibt, was in den einzelnen Ansichten enthalten sein kann. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
| Image | Image (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 Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition besonders für die Bildsteuerelemente relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elementen.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Hinweise |
|---|---|---|
| UIA_AutomationIdPropertyId | Siehe Hinweise. | Der Wert dieser Eigenschaft muss für alle Peerelemente in der Rohansicht der Benutzeroberflächenautomatisierung Struktur eindeutig sein. |
| UIA_BoundingRectanglePropertyId | Siehe Hinweise. | Das äußere 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 QuickInfoinformationen 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 es sich bei dem Bild um ein kompliziertes Diagramm handelt). Diese Eigenschaft wird dem HTML LongDesc-Tag und dem Desc-Tag (Scalable Vector Graphics, SVG) 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 Benutzeroberflächenautomatisierung VisualDescription-Eigenschaft zugeordnet werden. |
| UIA_IsContentElementPropertyId | 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. |
| UIA_IsControlElementPropertyId | TRUE | Das Image-Steuerelement ist stets in der Steuerelementansicht der Struktur der Benutzeroberflächenautomatisierung enthalten. |
| UIA_IsKeyboardFocusablePropertyId | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
| UIA_ItemStatusPropertyId | 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 das status ändert. Wenn ein Bild ein eigenständiges Steuerelement ist und den Status übermittelt, muss diese Eigenschaft unterstützt werden. |
| UIA_LabeledByPropertyId | Siehe Hinweise. | Wenn eine statische Textbeschriftung vorhanden ist, muss diese Eigenschaft einen Verweis auf dieses Steuerelement verfügbar machen. |
| UIA_LocalizedControlTypePropertyId | Siehe Hinweise. | Lokalisierte Zeichenfolge, die dem Image-Steuerelementtyp entspricht. Der Standardwert ist "image" für en-US oder English (USA). |
| UIA_NamePropertyId | Siehe Hinweise. | Die Name-Eigenschaft muss für alle Bildsteuerelemente 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 Bildsteuerelement rein dekorativ ist, darf es nur in der Steuerelementansicht der Benutzeroberflächenautomatisierung 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 des Frameworks festgelegt werden kann. Diese Eigenschaft wird dann der Name-Eigenschaft der Benutzeroberflächenautomatisierung zugeordnet. |
Erforderliche Steuerelementmuster
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Steuerelementmuster aufgeführt, die für Bildsteuerelemente 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 Imagesteuerelement 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 anklickbare Objekte enthält, kann das Element (Image-Steuerelementtyp) untergeordnete Links (Hyperlink-Steuerelementtyp) in der Benutzeroberflächenautomatisierung-Struktur hosten. |
| ISelectionItemProvider | Nie | Bildsteuerelemente sollten das SelectionItem-Steuerelementmuster nicht unterstützen. Wenn Bilder Teil eines auswählbaren Containers sind, z. B. eine Schaltfläche mit einem Bildsymbol als Inhalt, unterstützt dieser Container das Muster, nicht das darin enthaltene Image. |
| ITableItemProvider | Depends (Abhängig) | Das Imagesteuerelement unterstützt das TableItem-Steuerelementmuster , wenn sich das Steuerelement in einem Container mit Headersteuerelementen befindet. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die Imagesteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Ereignis der Benutzeroberflächenautomatisierung | Hinweise |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId Eigenschaft geändertes Ereignis. | |
| UIA_IsEnabledPropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_IsOffscreenPropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_ItemStatusPropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement die ItemStatus-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_NamePropertyId Eigenschaft geändertes Ereignis. | |
| 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 Informationen finden Sie im W3C-Thema zu dekorativen Bildern.
In Bezug auf Benutzeroberflächenautomatisierung:
- Wenn ein Bild rein dekorativ ist, nicht interaktiv ist und keine Informationen vermittelt, wird das Bild:
- Möglicherweise in der UIA-Struktur
- Möglicherweise nicht in der unformatierten UIA-Ansicht
- Darf sich nicht in der UIA-Steuerelementansicht befindet
- Darf sich nicht in der Inhaltsansicht enthalten
- Kann einen Namen haben oder nicht
- Wenn ein Bild Informationen vermittelt, aber eindeutig zugeordneter Text die gleichen Informationen bereitstellt (z. B. eine Wiedergabeschaltfläche, die eine links zeigende Dreiecksgrafik zusammen mit dem Text "Play") enthält, gilt das Bild als dekorativ und das Bild:
- Muss sich in der rohen Ansicht enthalten
- Muss in der Steuerelementansicht sein
- Darf sich nicht in der Inhaltsansicht enthalten
- Kann einen Wert in der Name-Eigenschaft aufweisen oder nicht
- Der Text, der auch die Bedeutung des Bilds vermittelt, muss in der Inhaltsansicht sein.
- Wenn ein Bild informativ ist und Details vermittelt, die von keinem zugeordneten Text bereitgestellt werden, ist das Bild wie folgt:
- Muss sich in der rohen Ansicht enthalten
- Muss in der Steuerelementansicht sein
- Muss in der Inhaltsansicht enthalten sein
- Muss über einen Namenswert verfügen, der das Bild und seine Bedeutung beschreibt.