DataItem-Steuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung des DataItem-Steuerelementtyps von Microsoft Benutzeroberflächenautomatisierung.
Ein Eintrag in einer Kontaktliste ist ein Beispiel für ein Datenelement-Steuerelement. Ein Datenelement-Steuerelement enthält Informationen, die für einen Endbenutzer von Interesse sind. Es ist komplizierter als das einfache Listenelement, da es mehr Informationen enthält.
In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den DataItem-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Datenelementsteuerelemente, bei denen das Benutzeroberflächenframework bzw. die Benutzeroberflächenplattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält folgende Abschnitte:
- Typische Struktur der Struktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Arbeiten mit DataItems in großen Listen
- Erforderliche Ereignisse
- Beispiel für DataItem-Steuerelementtyp
- Zugehörige Themen
Typische Struktur der Struktur
Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Datenelementsteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Ein DataItem-Element in einem Datenraster kann eine Vielzahl von Objekten hosten, wie etwa eine andere Ebene von Datenelementen oder bestimmte Rasterelemente, z. B. Text, Bilder oder Bearbeitungssteuerelemente. Wenn das Datenelementelement über eine bestimmte Objektrolle verfügt, sollte das Element als spezifischer 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 Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition für den DataItem-Steuerelementtyp 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 Rohansicht der Benutzeroberflächenautomatisierung-Struktur eindeutig sein. |
| UIA_BoundingRectanglePropertyId | Siehe Hinweise. | Das äußere Rechteck, das das gesamte Steuerelement enthält. |
| UIA_ClickablePointPropertyId | Siehe Hinweise. | Unterstützt, wenn es ein umschließendes Rechteck gibt. Wenn nicht jeder Punkt innerhalb des begrenzungsenden Rechtecks geklickt werden kann und das Element spezielle Treffertests ausführt, überschreiben Sie, und stellen Sie einen klickbaren Punkt bereit. |
| UIA_ControlTypePropertyId | DataItem | |
| UIA_IsContentElementPropertyId | TRUE | Das Datenelement-Steuerelement muss immer ein Inhaltselement sein. |
| UIA_IsControlElementPropertyId | TRUE | Das Datenelement-Steuerelement 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 status enthält, die dynamisch aktualisiert wird, muss diese Eigenschaft unterstützt werden, damit eine Hilfstechnologie Updates empfangen kann, wenn sich die status des Elements ändert. |
| UIA_ItemTypePropertyId | Siehe Hinweise. | Dies ist der Zeichenfolgenwert, der dem Endbenutzer das zugrunde liegende Objekt übermittelt, das vom Element dargestellt wird. Beispiele hierfür sind "Mediendatei" und "Kontakt". |
| UIA_LabeledByPropertyId | Null | Datenelement-Steuerelemente verfügen nicht über eine statische Textbezeichnung. |
| UIA_LocalizedControlTypePropertyId | Siehe Hinweise. | Lokalisierte Zeichenfolge, die dem DataItem-Steuerelementtyp 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 erkennen würde. |
Erforderliche Steuerelementmuster
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Steuerelementmuster aufgeführt, die von allen Datenelementsteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
| Steuerelementmuster | Support | Notizen |
|---|---|---|
| IExpandCollapseProvider | Depends (Abhängig) | Wenn das Datenelement erweitert oder reduziert werden kann, um Informationen anzuzeigen und auszublenden, muss das ExpandCollapse-Steuerelementmuster unterstützt werden. |
| IGridItemProvider | Depends (Abhängig) | Datenelemente unterstützen das GridItem-Steuerelementmuster , wenn eine Sammlung von Datenelementen in einem Container verfügbar ist, die räumlich von Element zu Element navigiert werden können. |
| IScrollItemProvider | Depends (Abhängig) | Alle Datenelemente unterstützen die Möglichkeit, mit dem ScrollItem-Steuerelementmuster in die Ansicht zu scrollen, wenn ihr Datencontainer mehr Elemente enthält, als auf den Bildschirm passen können. |
| ISelectionItemProvider | Depends (Abhängig) | Die Möglichkeit, die Datenelemente auszuwählen, hängt vom Inhalt ab. |
| ITableItemProvider | Depends (Abhängig) | Wenn das Datenelement in einem DataGrid-Steuerelementtyp enthalten ist, der über ein Headerelement verfügt, sollte es das TableItem-Steuerelementmuster unterstützen. |
| IToggleProvider | Depends (Abhängig) | Wenn das Datenelement einen Zustand enthält, der durchlaufen werden kann, sollte es das Umschaltsteuerungsmuster unterstützen. |
| IValueProvider | Depends (Abhängig) | Wenn der primäre Text des Datenelements bearbeitbar ist, muss das Wert-Steuerelementmuster unterstützt werden. |
Arbeiten mit DataItems in großen Listen
Da große Listen häufig innerhalb von Benutzeroberflächenframeworks virtualisiert werden, um die Leistung zu unterstützen, kann ein Benutzeroberflächenautomatisierung-Client das Benutzeroberflächenautomatisierung-Abfragefeature nicht verwenden, um den Inhalt der vollständigen Struktur auf die gleiche Weise wie in anderen Elementcontainern zu durchsuchen. Ein Client sollte das Element in die Ansicht scrollen (oder das Steuerelement erweitern, um alle verfügbaren Optionen anzuzeigen), bevor er auf den vollständigen Informationssatz aus dem Datenelement zugreift.
Beim Aufrufen von SetFocus für das Benutzeroberflächenautomatisierung-Element für das Datenelement gibt Microsoft Windows Explorer erfolgreich zurück und bewirkt, dass der Fokus auf das Steuerelement Bearbeiten innerhalb der Datenelementunterstruktur festgelegt wird.
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die Datenelementsteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Ereignis der Benutzeroberflächenautomatisierung | Notizen |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId Eigenschaft geändertes Ereignis. | |
| UIA_ExpandCollapseExpandCollapseStatePropertyId Eigenschaft geändertes Ereignis. | 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 Eigenschaft geändertes Ereignis. | Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_IsOffscreenPropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_ItemStatusPropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement die ItemStatus-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_NamePropertyId Eigenschaft geändertes Ereignis. | |
| 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 Eigenschaft geändertes Ereignis. | Wenn das Steuerelement das Umschalter-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_ValueValuePropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement das Value-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
Beispiel für DataItem-Steuerelementtyp
Die folgende Abbildung veranschaulicht einen DataItem-Steuerelementtyp in einem Listenansicht-Steuerelement.
Die Steuerelementansicht und die Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf das Datenelementsteuerelement bezieht, werden unten angezeigt. Die Steuerelementmuster für jedes Automatisierungselement sind in Klammern aufgeführt. Die Gruppe "Contoso" ist auch Teil des Rasters des Datenrasterhoststeuerelements. Ein Beispiel für eine Übergeordnete Rasterstruktur finden Sie unter DataGrid-Steuerelementtyp.
| Struktur der Benutzeroberflächenautomatisierung – Steuerelementansicht | Struktur der Benutzeroberflächenautomatisierung – Inhaltsansicht |
|---|---|
|
|
Wenn ein Raster eine Liste auswählbarer Elemente darstellt, können die entsprechenden auswählbaren UI-Elemente mit dem ListItem-Steuerelementtyp anstelle des DataItem-Steuerelementtyps verfügbar gemacht werden. Im vorherigen Beispiel können die DataItem-Elemente ("Konten Receivable.doc" und "Konten Payable.doc") unter Group ("Contoso") verbessert werden, indem sie als ListItem-Steuerelementtypen verfügbar sind, da dieser Typ bereits das SelectionItem-Steuerelementmuster unterstützt.
Zugehörige Themen