Benutzeroberflächenautomatisierungs-Unterstützung für den Document-Steuerelementtyp

Aktualisiert: November 2007

Dieses Thema enthält Informationen über die UI-Automatisierung-Unterstützung für den Document-Steuerelementtyp. In 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.

Mithilfe von Document-Steuerelementen kann ein Benutzer mehrere Seiten Text anzeigen und ändern.

In den folgenden Abschnitten werden die UI-Automatisierung-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den Document-Steuerelementtyp erforderlich sind. Die UI-Automatisierung-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-Automatisierung-Struktur, die sich auf Document-Steuerelemente bezieht, dargestellt und die möglichen Inhalte jeder Ansicht beschrieben. Weitere Informationen über die UI-Automatisierung-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht

Inhaltsansicht

  • Document

  • Variabel

  • Document

  • Variabel

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle werden die UI-Automatisierung-Eigenschaften aufgelistet, deren Werte oder Definitionen für Document-Steuerelemente besonders wichtig 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.

BoundingRectangleProperty

Siehe Hinweise.

Das äußere Rechteck, welches das gesamte Steuerelement umfasst.

ClickablePointProperty

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.

ControlTypeProperty

Document

Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.

IsContentElementProperty

True

Das Document-Steuerelement ist stets in der Inhaltsansicht der UI-Automatisierung-Struktur enthalten.

IsControlElementProperty

True

Das Document-Steuerelement ist stets in der Steuerelementansicht der UI-Automatisierung-Struktur enthalten.

IsKeyboardFocusableProperty

Siehe Hinweise.

Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.

LabeledByProperty

Siehe Hinweise.

Der Wert dieser Eigenschaft sollte die Bezeichnung des Document-Steuerelements sein. In der Regel wird der Titel des Dokuments verwendet.

LocalizedControlTypeProperty

"Dokument"

Lokalisierte Zeichenfolge, die dem Document-Steuerelementtyp entspricht.

NameProperty

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-Automatisierung-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/Mustereigenschaft

Unterstützung/Wert

Hinweise

IScrollProvider

Variabel

Wenn ein Dokument mehr als eine Seite umfasst, sollte das Steuerelement dieses Steuerelementmuster implementieren. Wenn sich ein Dokument jedoch über mehrere Seiten erstreckt, muss das Steuerelement dieses Steuerelementmuster nicht unterstützen.

ITextProvider

Required

Alle Document-Steuerelemente müssen dieses Steuerelementmuster unterstützen.

IValueProvider

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-Automatisierung-Ereignisse aufgeführt, die von allen Document-Steuerelementen unterstützt werden müssen. Weitere Informationen über Ereignisse finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.

UI-Automatisierung-Ereignis

Unterstützung

Hinweise

AutomationFocusChangedEvent

Required

None

Durch geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis.

Required

None

Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis.

Required

None

Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis.

Required

None

StructureChangedEvent

Required

None

Durch geänderte HorizontallyScrollableProperty-Eigenschaft ausgelöstes Ereignis.

Required

None

Durch geänderte HorizontalScrollPercentProperty-Eigenschaft ausgelöstes Ereignis.

Required

None

Durch geänderte HorizontalViewSizeProperty-Eigenschaft ausgelöstes Ereignis.

Required

None

Durch geänderte VerticalScrollPercentProperty-Eigenschaft ausgelöstes Ereignis.

Required

None

Durch geänderte VerticallyScrollableProperty-Eigenschaft ausgelöstes Ereignis.

Required

None

Durch geänderte VerticalViewSizeProperty-Eigenschaft ausgelöstes Ereignis.

Required

None

InvalidatedEvent

Variabel

Wenn das Steuerelement das Selection-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.

TextSelectionChangedEvent

Required

None

TextChangedEvent

Required

None

Durch geänderte ValueProperty-Eigenschaft ausgelöstes Ereignis.

Nie

None

Siehe auch

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung

Referenz

Document