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.
.gif "Hinweis") 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 über die UI Automation-Unterstützung für den Document-Steuerelementtyp. In 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.
Mithilfe von Document-Steuerelementen kann ein Benutzer mehrere Seiten Text anzeigen und ändern. Im Gegensatz zu Bearbeitungssteuerelementen, die nur eine einfache Zeile unformatierten Texts unterstützen, können Document-Steuerelemente aufwändig formatierten Text hosten.
In den folgenden Abschnitten werden die UI Automation-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den Document-Steuerelementtyp erforderlich sind. Die UI Automation-Anforderungen gelten für alle Document-Steuerelemente, einschließlich Windows Presentation Foundation (WPF), Win32 und Windows Forms.
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, die sich auf Document-Steuerelemente bezieht, dargestellt und die möglichen Inhalte jeder Ansicht beschrieben. Weitere Informationen über die UI Automation-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.
Steuerelementansicht |
Inhaltsansicht |
|---|---|
Document
|
Document
|
Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
In der folgenden Tabelle werden die UI Automation-Eigenschaften aufgelistet, deren Werte oder Definitionen für Document-Steuerelemente besonders wichtig sind. Weitere Informationen zu UI Automationseigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.
UI Automation-Eigenschaft |
Wert |
Hinweise |
|---|---|---|
Siehe Hinweise. |
Der Wert dieser Eigenschaft muss für alle Steuerelemente einer Anwendung eindeutig sein. |
|
Siehe Hinweise. |
Das äußere Rechteck, welches das gesamte Steuerelement umfasst. |
|
Siehe Hinweise. |
Das Document-Steuerelement enthält einen durch Klicken aktivierbaren Punkt, mit dem der Fokus auf das Dokument oder auf eines der Elemente im Dokumentcontainer gelegt werden kann. |
|
Document |
Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
|
True |
Das Document-Steuerelement ist stets in der Inhaltsansicht der UI Automation-Struktur enthalten. |
|
True |
Das Document-Steuerelement ist stets in der Steuerelementansicht der UI Automation-Struktur enthalten. |
|
Siehe Hinweise. |
Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
|
Siehe Hinweise. |
Der Wert dieser Eigenschaft sollte die Bezeichnung des Document-Steuerelements sein. In der Regel wird der Titel des Dokuments verwendet. |
|
"Dokument" |
Lokalisierte Zeichenfolge, die dem Document-Steuerelementtyp entspricht. |
|
Siehe Hinweise. |
Das Document-Steuerelement ruft seinen Namen in der Regel aus dem Namen der Datei ab, aus der es geladen wird. Dieser wird oft im Titel eines umgebenden Fensters oder Rahmens angezeigt. |
Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung
In der folgenden Tabelle sind die UI Automation-Steuerelementmuster aufgeführt, die von allen Document-Steuerelementen unterstützt werden müssen. Weitere Informationen über Steuerelementmuster finden Sie unter Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung.
Steuerelementmuster |
Unterstützung |
Hinweise |
|---|---|---|
Variabel |
Das Document-Steuerelement kann einen größeren Bereich umfassen als der Viewport. Das Steuerelement muss das Scroll-Steuerelementmuster unterstützen, wenn der Inhalt bildlauffähig ist. |
|
Erforderlich |
Das Document-Steuerelement kann einen größeren Bereich umfassen als der Viewport. Das Steuerelement muss das Scroll-Steuerelementmuster unterstützen, wenn der Inhalt bildlauffähig ist. |
|
Nie |
Das Document-Steuerelement unterstützt dieses Steuerelementmuster nicht, da sich der Inhalt des Steuerelements häufig über mehrere Seiten erstreckt. Benutzeroberflächenautomatisierungs-Clients sollten TextPattern verwenden, um Textinformationen zu einem Dokument zu erhalten. |
Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
In der folgenden Tabelle sind die UI Automation-Ereignisse aufgeführt, die von allen Document-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.
UI Automation-Ereignis |
Unterstützung |
Hinweise |
|---|---|---|
Erforderlich |
Keine |
|
Durch geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis |
Erforderlich |
Keine |
Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis |
Erforderlich |
Keine |
Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis |
Erforderlich |
Keine |
Erforderlich |
Keine |
|
Durch geänderte HorizontallyScrollableProperty-Eigenschaft ausgelöstes Ereignis |
Erforderlich |
Keine |
Durch geänderte HorizontalScrollPercentProperty-Eigenschaft ausgelöstes Ereignis |
Erforderlich |
Keine |
Durch geänderte HorizontalViewSizeProperty-Eigenschaft ausgelöstes Ereignis |
Erforderlich |
Keine |
Durch geänderte VerticalScrollPercentProperty-Eigenschaft ausgelöstes Ereignis |
Erforderlich |
Keine |
Durch geänderte VerticallyScrollableProperty-Eigenschaft ausgelöstes Ereignis |
Erforderlich |
Keine |
Durch geänderte VerticalViewSizeProperty-Eigenschaft ausgelöstes Ereignis |
Erforderlich |
Keine |
Variabel |
Wenn das Steuerelement das Selection-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
|
Erforderlich |
Keine |
|
Erforderlich |
Keine |
|
Durch geänderte ValueProperty-Eigenschaft ausgelöstes Ereignis |
Nie |
Keine |
Siehe auch
Referenz
Konzepte
Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung