Freigeben über

Dokumentsteuerelementtyp

Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den steuerelementtyp Document.

Dokumentsteuerelemente ermöglichen es einem Benutzer, mehrere Seiten von Text anzuzeigen und zu bearbeiten. Im Gegensatz zu Bearbeitungssteuerelementen, die nur eine einfache Unformatierte Textzeile unterstützen, können Dokumentsteuerelemente Text hosten, der reich formatiert und formatiert ist.

In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Document-Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Dokumentsteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform die Benutzeroberflächenautomatisierungsunterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält die folgenden Abschnitte.

Typische Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Dokumentsteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.

Steuerelementansicht Inhaltsansicht
  • Dokument
    • Variiert
  • Dokument
    • Variiert

 

Relevante Eigenschaften

In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für Dokumentsteuerelemente relevant ist. Weitere Informationen zu Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Abrufen von Eigenschaften aus benutzeroberflächenautomatisierungs-Elementen.

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Notizen
UIA_AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss zwischen allen Peerelementen in der unformatierten Ansicht der Benutzeroberflächenautomatisierungs-Struktur eindeutig sein.
UIA_BoundingRectanglePropertyId Siehe Hinweise. Das äußerste Rechteck, das das gesamte Steuerelement enthält.
UIA_ClickablePointPropertyId Siehe Hinweise. Das Dokument weist einen klickbaren Punkt auf, der dazu führt, dass das Dokument eines seiner Elemente im Dokumentcontainer den Fokus hat.
UIA_ControlTypePropertyId Dokument-
UIA_IsContentElementPropertyId STIMMT Das Dokumentsteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten.
UIA_IsControlElementPropertyId STIMMT Das Dokumentsteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten.
UIA_IsKeyboardFocusablePropertyId Siehe Hinweise. Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
UIA_LabeledByPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft sollte die Bezeichnung des Dokumentsteuerelements sein. Normalerweise wird der Titel des Dokuments verwendet.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem steuerelementtyp Document entspricht. Der Standardwert ist "document" für en-US oder Englisch (USA).
UIA_NamePropertyId Siehe Hinweise. Das Dokumentsteuerelement ruft in der Regel seinen Namen aus dem Dateinamen ab, aus dem es geladen wird. Dies wird häufig in einem enthaltenden Fenster- oder Rahmentitel angezeigt.

 

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von Dokumentsteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.

Control Pattern/Pattern-Eigenschaft Support/Wert Notizen
IScrollProvider- Hängt Das Dokumentsteuerelement kann größer als dieser Bereich des Viewports sein. Das Steuerelement sollte das Scroll- Steuerelementmuster unterstützen, wenn der Inhalt scrollbar ist.
ITextProvider- Erforderlich Alle Dokumentsteuerelemente müssen das Text- Steuerelementmuster unterstützen.
IValueProvider- Hängt Während Benutzeroberflächenautomatisierungs-Clients IUIAutomationTextPattern verwenden können, um Textinformationen zu einem Dokument abzurufen, benötigen sie das Wert- Steuerelementmusters, um den inneren Wert festzulegen. Einfache Texteingabe ist nur über das Wert-Steuerelementmuster möglich.

 

Erforderliche Ereignisse

In der folgenden Tabelle sind die Ereignisse der Benutzeroberflächenautomatisierung aufgeführt, die Dokumentsteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter Ui Automation Events Overview.

Benutzeroberflächenautomatisierungs-Ereignis Notizen
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaftsänderungsereignis.
UIA_IsEnabledPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsEnabled--Eigenschaft unterstützt, muss dieses Ereignis unterstützt werden.
UIA_IsOffscreenPropertyId Ereignis mit Eigenschaftsänderung. Wenn das Steuerelement die IsOffscreen--Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_StructureChangedEventId
UIA_ScrollHorizontallyScrollablePropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das Scroll- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollHorizontalScrollPercentPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das Scroll- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollHorizontalViewSizePropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das Scroll- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollVerticallyScrollablePropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das Scroll- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollVerticalScrollPercentPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das Scroll- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollVerticalViewSizePropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das Scroll- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_Selection_InvalidatedEventId Wenn das Steuerelement das Selection Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_Text_TextSelectionChangedEventId
UIA_Text_TextChangedEventId
UIA_ValueValuePropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das Wert- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.

 

Konzeptionelle

Übersicht über Steuerelementtypen für die Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung