Dokumentsteuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung von Microsoft Benutzeroberflächenautomatisierung für den Steuerelementtyp "Dokument".
Mithilfe von Dokumentsteuerelementen kann ein Benutzer mehrere Seiten Text anzeigen und bearbeiten. Im Gegensatz zu Bearbeitungssteuerelementen, die nur eine einfache Zeile mit unformatiertem Text unterstützen, können Dokumentsteuerelemente Text mit umfangreichem Format hosten.
In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Steuerelementtyp Document definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Dokumentsteuerelemente, bei denen das Benutzeroberflächenframework bzw. die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält folgende Abschnitte:
- Typische Struktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Zugehörige Themen
Typische Struktur
Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die dokumentsteuerelemente betrifft, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierung-Struktur finden Sie unter übersicht über Benutzeroberflächenautomatisierung Struktur.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Relevante Eigenschaften
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition für Dokumentsteuerelemente besonders relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Notizen |
|---|---|---|
| UIA _ AutomationIdPropertyId | Siehe Hinweise. | Der Wert dieser Eigenschaft muss für alle Peerelemente in der rohen Ansicht der Benutzeroberflächenautomatisierung-Struktur eindeutig sein. |
| UIA _ BoundingRectanglePropertyId | Siehe Hinweise. | Das äußere Rechteck, das das gesamte Steuerelement enthält. |
| UIA _ ClickablePointPropertyId | Siehe Hinweise. | Das Dokument hat einen klickbaren Punkt, über den veranlasst werden kann, dass das Dokument oder eines seiner Elemente im Dokumentcontainer den Fokus erhält. |
| UIA _ ControlTypePropertyId | Dokument | |
| UIA _ IsContentElementPropertyId | TRUE | Das Dokumentsteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur enthalten. |
| UIA _ IsControlElementPropertyId | TRUE | Das Dokumentsteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierung-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 muss die Bezeichnung des Dokumentsteuerelements sein. In der Regel wird der Titel des Dokuments verwendet. |
| UIA _ LocalizedControlTypePropertyId | Siehe Hinweise. | Lokalisierte Zeichenfolge, die dem Steuerelementtyp Dokument entspricht. Der Standardwert ist "document" für en-US oder Englisch (USA). |
| _UIA-NamePropertyId | Siehe Hinweise. | Das Dokumentsteuerelement erhält seinen Namen in der Regel aus dem Dateinamen, aus dem es geladen wird. Dieser wird häufig im Titel eines umgebenden Fensters oder Rahmens angezeigt. |
Erforderliche Steuerelementmuster
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Steuerelementmuster aufgeführt, die von Dokumentsteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
| Steuerelementmuster/Mustereigenschaft | Unterstützung/Wert | Notizen |
|---|---|---|
| IScrollProvider | Depends (Abhängig) | Das Dokumentsteuerelement kann einen Bereich umfassen, der größer ist als der Bereich des Viewports. 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 | Depends (Abhängig) | Obwohl Benutzeroberflächenautomatisierung Clients IUIAutomationTextPattern verwenden können, um Textinformationen zu einem Dokument abzurufen, benötigen sie das Value-Steuerelementmuster, um den inneren Wert festzulegen. Ein einfacher Texteintrag ist nur über das Value-Steuerelementmuster möglich. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die von Dokumentsteuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Benutzeroberflächenautomatisierung-Ereignis | Notizen |
|---|---|
| UIA _ AutomationFocusChangedEventId | |
| UIA _ Das BoundingRectanglePropertyId-Eigenschaftswechselereignis. | |
| UIA _ Das IsEnabledPropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ IsOffscreenPropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ StructureChangedEventId | |
| UIA _ ScrollHorizontallyScrollablePropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ ScrollHorizontalScrollPercentPropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ ScrollHorizontalViewSizePropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ ScrollVerticallyScrollablePropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ ScrollVerticalScrollPercentPropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ ScrollVerticalViewSizePropertyId-Eigenschaftswechselereignis. | 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-Eigenschaftswechselereignis. | Wenn das Steuerelement das Value-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |