Benutzeroberflächenautomatisierungs-Unterstützung für den Document-Steuerelementtyp
.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