Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Aktualisiert: November 2007
Dieses Thema enthält Informationen zur UI-Automatisierung-Unterstützung für den Image-Steuerelementtyp. In der UI-Automatisierung 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-Automatisierung-Struktur, UI-Automatisierung-Eigenschaftenwerte und Steuerelementmuster ein.
Image-Steuerelemente, die als Symbole, Informationsgrafiken und Diagramme verwendet werden, unterstützen den Image-Steuerelementtyp. Hintergrundbilder und mit Wasserzeichen versehene Bilder unterstützen den Image-Steuerelementtyp nicht.
In den folgenden Abschnitten werden die UI-Automatisierung-Struktur, Eigenschaften, Steuerelementmuster und Ereignisse definiert, die für den Image-Steuerelementtyp erforderlich sind. Die UI-Automatisierung-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-Automatisierung-Struktur für Image-Steuerelemente beschrieben sowie der Inhalt der einzelnen Ansichten erläutert. Weitere Informationen über die UI-Automatisierung-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.
Steuerelementansicht |
Inhaltsansicht |
|---|---|
|
|
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
In der folgenden Tabelle sind die UI-Automatisierung-Eigenschaften aufgelistet, deren Werte oder Definitionen für den Image-Steuerelementtyp besonders relevant sind. Weitere Informationen über die UI-Automatisierung-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.
UI-Automatisierung-Eigenschaft |
Wert |
Hinweise |
|---|---|---|
AutomationIdProperty() |
Siehe Hinweise. |
Der Wert dieser Eigenschaft muss für alle Steuerelemente einer Anwendung eindeutig sein. |
Siehe Hinweise. |
Das äußere, das gesamte Steuerelement umfassende Rechteck. |
|
Siehe Hinweise. |
Der klickbare Punkt des Image-Steuerelements muss ein Punkt innerhalb des umschließenden Rechtecks des Image-Steuerelements sein. |
|
Siehe Hinweise. |
Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
|
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-Automatisierung-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-Automatisierung-Name-Eigenschaft zugeordnet. |
|
Siehe Hinweise. |
Wenn eine statische Textbezeichnung vorhanden ist, muss diese Eigenschaft einen Verweis auf das entsprechende Steuerelement verfügbar machen. |
|
Image |
Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
|
"Bild" |
Lokalisierte Zeichenfolge für den Image-Steuerelementtyp. |
|
Siehe Hinweise. |
Das Image-Steuerelement muss in der Inhaltsansicht der UI-Automatisierung-Struktur enthalten sein, wenn es relevante Informationen enthält, die dem Endbenutzer noch nicht verfügbar gemacht wurden. |
|
True |
Das Image-Steuerelement ist in der Steuerelementansicht der UI-Automatisierung-Struktur immer enthalten. |
|
Siehe Hinweise. |
Die HelpText-Eigenschaft macht eine lokalisierte Zeichenfolge verfügbar, die die tatsächliche visuelle Darstellung des Steuerelements beschreibt (z. B. "Rotes Quadrat mit einem weißen 'X'"). 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-LongDesc-Tag und dem Skalierbare Vektorgrafiken (SVG)-Desc-Tag 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 UI-Automatisierung-VisualDescription-Eigenschaft zugeordnet werden. Dies ist normalerweise erforderlich, wenn das Bild als Inhaltssteuerelement verwendet wird. |
|
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-Automatisierung-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/Mustereigenschaft |
Unterstützung/Wert |
Hinweise |
|---|---|---|
Variabel |
Das Image-Steuerelement unterstützt das GridItem-Muster, wenn sich das Steuerelement innerhalb eines Rastercontainers befindet. |
|
Variabel |
Das Image-Steuerelement unterstützt das TableItem-Muster, wenn sich das Steuerelement innerhalb eines Containers mit Header-Steuerelementen befindet. |
|
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. |
|
Nie |
Image-Steuerelemente sollten das SelectionItem-Muster nicht unterstützen. |
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
In der folgenden Tabelle sind die UI-Automatisierung-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-Automatisierung-Ereignis |
Unterstützung |
Hinweise |
|---|---|---|
Nie |
Keine |
|
Nie |
Keine |
|
Nie |
Keine |
|
Nie |
Keine |
|
Durch geänderte Eigenschaft ausgelöstes BoundingRectangleProperty-Ereignis. |
Erforderlich |
Keine |
Durch geänderte Eigenschaft ausgelöstes IsOffscreenProperty-Ereignis. |
Erforderlich |
Keine |
Durch geänderte Eigenschaft ausgelöstes IsEnabledProperty-Ereignis. |
Erforderlich |
Keine |
Durch geänderte Eigenschaft ausgelöstes NameProperty-Ereignis. |
Erforderlich |
Keine |
Erforderlich |
Keine |
|
Erforderlich |
Keine |
Siehe auch
Konzepte
Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung
Übersicht über die Benutzeroberflächenautomatisierung