Freigeben über


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 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
  • DataItem
    • Variiert (0 oder mehr; kann in der Hierarchie strukturiert werden)
  • DataItem
    • Variiert (0 oder mehr; kann in der Hierarchie strukturiert werden)

 

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.

Screenshot des Listenansicht-Steuerelements mit dem Datentyp

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
  • Gruppe "Contoso" (Tabelle, Raster)
    • DataItem "Accounts Receivable.doc" (TableItem, GridItem, SelectionItem, Invoke)
      • Bild "Konten Receivable.doc"
      • Bearbeiten von "Name" (TableItem, GridItem, Value "Accounts Receivable.doc")
      • Bearbeiten von "Datum geändert" (TableItem, GridItem, Value "8/25/2006 3:29 PM")
      • Bearbeiten von "Size" (GridItem, TableItem, Value "11.0 KB")
    • DataItem "Accounts Payable.doc" (TableItem, GridItem, SelectionItem, Invoke)
      • ...
  • Gruppe "Contoso" (Tabelle, Raster)
    • DataItem "Accounts Receivable.doc" (TableItem, GridItem, SelectionItem, Invoke)
      • Bild "Konten Receivable.doc"
      • Bearbeiten von "Name" (TableItem, GridItem, Value "Accounts Receivable.doc")
      • Bearbeiten von "Datum geändert" (TableItem, GridItem, Value "8/25/2006 3:29 PM")
      • Bearbeiten von "Size" (GridItem, TableItem, Value "11.0 KB")
    • DataItem "Accounts Payable.doc" (TableItem, GridItem, SelectionItem, Invoke)
      • ...

 

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.

Konzeptionelle

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

Übersicht über die Benutzeroberflächenautomatisierung