DataItem-Steuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den DataItem- Steuerelementtyp.
Ein Eintrag in einer Kontaktliste ist ein Beispiel für ein Datenelementsteuerelement. Ein Datenelementsteuerelement enthält Informationen, die für einen Endbenutzer von Interesse sind. Es ist komplizierter als das einfache Listenelement, da es umfangreichere Informationen enthält.
In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den DataItem- Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Datenelementsteuerelemente, 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 Strukturstruktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Arbeiten mit DataItems in großen Listen
- Erforderliche Ereignisse
- DataItem-Steuerelementtyp (Beispiel)
- Verwandte Themen
Typische Struktur
Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Datenelementsteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Ein Datenelementelement in einem Datenraster kann eine Vielzahl von Objekten hosten, einschließlich einer anderen Ebene von Datenelementen oder bestimmte Rasterelemente wie Text, Bilder oder Bearbeitungssteuerelemente. Wenn das Datenelementelement über eine bestimmte Objektrolle verfügt, sollte das Element als bestimmter Steuerelementtyp verfügbar gemacht werden. Beispielsweise ein ListItem Steuerelementtyp für ein auswählbares Datenelement im Raster.
Relevante Eigenschaften
In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für den DataItem-Steuerelementtyp 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. | Wird unterstützt, wenn ein umgebendes Rechteck vorhanden ist. Wenn nicht jeder Punkt innerhalb des umgebenden Rechtecks klickbar ist und das Element spezielle Treffertests durchführt, überschreiben Und stellen Sie einen klickbaren Punkt bereit. |
| UIA_ControlTypePropertyId | DataItem- | |
| UIA_IsContentElementPropertyId | STIMMT | Das Datenelementsteuerelement muss immer Inhalt sein. |
| UIA_IsControlElementPropertyId | STIMMT | Das Datenelementsteuerelement muss immer ein Steuerelement sein. |
| UIA_IsKeyboardFocusablePropertyId | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
| UIA_ItemStatusPropertyId | Siehe Hinweise. | Wenn das Steuerelement den Status enthält, der dynamisch aktualisiert wird, muss diese Eigenschaft unterstützt werden, damit eine Hilfstechnologie Aktualisierungen empfangen kann, wenn sich der Status des Elements ändert. |
| UIA_ItemTypePropertyId | Siehe Hinweise. | Dies ist der Zeichenfolgenwert, der dem Endbenutzer das zugrunde liegende Objekt, das das Element darstellt, vermittelt. Beispiele sind "Mediendatei" und "Kontakt". |
| UIA_LabeledByPropertyId | Null | Datenelementsteuerelemente verfügen nicht über eine statische Textbezeichnung. |
| UIA_LocalizedControlTypePropertyId | Siehe Hinweise. | Lokalisierte Zeichenfolge, die dem steuerelementtyp DataItem entspricht. Der Standardwert ist "Datenelement" für en-US oder Englisch (USA). |
| UIA_NamePropertyId | Siehe Hinweise. | Das Datenelementsteuerelement enthält immer ein primäres Textelement, das der Benutzer als Bezeichner für das Element erkennt. |
Erforderliche Steuerelementmuster
In der folgenden Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von allen Datenelementsteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.
| Steuerelementmuster | Unterstützen | Notizen |
|---|---|---|
| IExpandCollapseProvider | Hängt | Wenn das Datenelement erweitert oder reduziert werden kann, um Informationen anzuzeigen und auszublenden, muss das ExpandCollapse Steuerelementmuster unterstützt werden. |
| IGridItemProvider- | Hängt | Datenelemente unterstützen das GridItem- Steuerelementmusters, wenn eine Sammlung von Datenelementen in einem Container verfügbar ist, der räumliche navigationsfähige Elemente zu Element sein kann. |
| IScrollItemProvider- | Hängt | Alle Datenelemente unterstützen die Möglichkeit, mit dem ScrollItem- Steuerelementmuster in der Ansicht zu scrollen, wenn ihr Datencontainer mehr Elemente enthält, als auf den Bildschirm passen können. |
| ISelectionItemProvider- | Hängt | Die Möglichkeit zum Auswählen der Datenelemente hängt vom Inhalt ab. |
| ITableItemProvider- | Hängt | Wenn das Datenelement in einem DataGrid- Steuerelementtyp enthalten ist, der über ein Headerelement verfügt, sollte es das TableItem- Steuerelementmuster unterstützen. |
| IToggleProvider- | Hängt | Wenn das Datenelement einen Zustand enthält, der durchlaufen werden kann, sollte es das Umschalten Steuerelementmusters unterstützen. |
| IValueProvider- | Hängt | Wenn der primäre Text des Datenelements bearbeitbar ist, muss das Wert Steuerelementmusters unterstützt werden. |
Arbeiten mit DataItems in großen Listen
Da große Listen häufig in Benutzeroberflächenframeworks virtualisiert werden, um die Leistung zu unterstützen, kann ein Benutzeroberflächenautomatisierungs-Client das Abfragefeature der Benutzeroberflächenautomatisierung nicht verwenden, um den Inhalt der vollständigen Struktur auf die gleiche Weise zu durchsuchen wie in anderen Elementcontainern. Ein Client sollte das Element in der Ansicht scrollen (oder das Steuerelement erweitern, um alle verfügbaren Optionen anzuzeigen), bevor auf den vollständigen Satz von Informationen aus dem Datenelement zugegriffen wird.
Beim Aufrufen SetFocus- für das Benutzeroberflächenautomatisierungs-Element für das Datenelement gibt Microsoft Windows Explorer erfolgreich zurück und bewirkt, dass der Fokus auf das Bearbeitungssteuerelement innerhalb der Unterstruktur des Datenelements festgelegt wird.
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungsereignisse aufgeführt, die Datenelementsteuerelemente 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_ExpandCollapseExpandCollapseStatePropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement das ExpandCollapse Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_Invoke_InvokedEventId | Wenn das Steuerelement das Invoke Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| 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_ItemStatusPropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement die ItemStatus--Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_NamePropertyId Eigenschaftsänderungsereignis. | |
| UIA_SelectionItem_ElementAddedToSelectionEventId | Wenn das Steuerelement das SelectionItem- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_SelectionItem_ElementRemovedFromSelectionEventId | Wenn das Steuerelement das SelectionItem- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_SelectionItem_ElementSelectedEventId | Wenn das Steuerelement das SelectionItem- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_StructureChangedEventId | |
| UIA_ToggleToggleStatePropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement das Umschalten Steuerelementmusters unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_ValueValuePropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement das Wert- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
DataItem-Steuerelementtyp (Beispiel)
Die folgende Abbildung zeigt einen DataItem-Steuerelementtyp in einem Listenansicht-Steuerelement.
Die Steuerelementansicht und die Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf das Datenelementsteuerelement bezieht, wird unten angezeigt. Die Steuerelementmuster für jedes Automatisierungselement werden in Klammern angezeigt. Die Gruppe "Contoso" ist ebenfalls Teil des Rasters des Datenrasterhoststeuerelements. Ein Beispiel für eine Rasterstruktur auf höherer Ebene finden Sie unter DataGrid Control Type.
| Benutzeroberflächenautomatisierungsstruktur – Steuerelementansicht | Benutzeroberflächenautomatisierungsstruktur – Inhaltsansicht |
|---|---|
|
|
Wenn ein Raster eine Liste auswählbarer Elemente darstellt, können die entsprechenden auswählbaren UI-Elemente mit dem ListItem- Steuerelementtyp anstelle des Datentyps des DataItem-Steuerelements verfügbar gemacht werden. Im vorherigen Beispiel können die DataItem- Elemente ("Accounts Receivable.doc" und "Accounts Payable.doc") unter Group ("Contoso") verbessert werden, indem sie sie als ListItem-Steuerelementtypen verfügbar machen, da dieser Typ bereits das SelectionItem- Steuerelementmuster unterstützt.
Verwandte Themen
-
Konzeptionelle
-
Übersicht über Steuerelementtypen für die Benutzeroberflächenautomatisierung