Typ kontrolki DataItem
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla dataitem typu kontrolki.
Wpis na liście Kontakty jest przykładem kontrolki elementu danych. Kontrolka elementu danych zawiera informacje interesujące użytkownika końcowego. Jest bardziej skomplikowany niż prosty element listy, ponieważ zawiera on bogatsze informacje.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla DataItem typu kontrolki. Wymagania automatyzacji interfejsu użytkownika mają zastosowanie do wszystkich kontrolek elementów danych, w których platforma/platforma interfejsu użytkownika integruje obsługę automatyzacji interfejsu użytkownika dla typów kontrolek i wzorców kontrolek.
Ten temat zawiera następujące sekcje.
- typowa struktura drzewa
- odpowiednie właściwości
- wymagane wzorce kontrolek
- praca z elementami DataItems na dużych listach
- wymagane zdarzenia
- przykładowy typ kontrolki DataItem
- Tematy pokrewne
Typowa struktura drzewa
W poniższej tabeli przedstawiono typowy widok kontrolki i zawartości drzewa automatyzacji interfejsu użytkownika odnoszącego się do kontrolek elementów danych i opisano, co można zawierać w każdym widoku. Aby uzyskać więcej informacji na temat drzewa automatyzacji interfejsu użytkownika, zobacz Omówienie drzewa automatyzacji interfejsu użytkownika.
| Widok kontrolki | Widok zawartości |
|---|---|
|
|
Element elementu danych w siatce danych może hostować różne obiekty, w tym inną warstwę elementów danych lub określone elementy siatki, takie jak tekst, obrazy lub kontrolki edycji. Jeśli element elementu danych ma określoną rolę obiektu, element powinien być uwidoczniony jako określony typ kontrolki; na przykład typ kontrolki ListItem dla wybranego elementu danych w siatce.
Odpowiednie właściwości
W poniższej tabeli wymieniono właściwości automatyzacji interfejsu użytkownika, których wartość lub definicja jest szczególnie istotna dla typu kontrolki DataItem. Aby uzyskać więcej informacji na temat właściwości automatyzacji interfejsu użytkownika, zobacz Pobieranie właściwości z elementów automatyzacji interfejsu użytkownika.
| Właściwość automatyzacji interfejsu użytkownika | Wartość | Notatki |
|---|---|---|
| UIA_AutomationIdPropertyId | Zobacz uwagi. | Wartość tej właściwości musi być unikatowa wśród wszystkich elementów równorzędnych w nieprzetworzonym widoku drzewa automatyzacji interfejsu użytkownika. |
| UIA_BoundingRectanglePropertyId | Zobacz uwagi. | Najbardziej oddalony prostokąt, który zawiera całą kontrolkę. |
| UIA_ClickablePointPropertyId | Zobacz uwagi. | Obsługiwane, jeśli istnieje prostokąt ograniczenia. Jeśli nie każdy punkt w obrębie prostokąta ograniczenia jest klikalny, a element wykonuje wyspecjalizowane testowanie trafień, przesłonięć i zapewnić punkt możliwy do kliknięcia. |
| UIA_ControlTypePropertyId | DataItem | |
| UIA_IsContentElementPropertyId | PRAWDZIWY | Kontrolka elementu danych musi zawsze być zawartością. |
| UIA_IsControlElementPropertyId | PRAWDZIWY | Kontrolka elementu danych musi zawsze być kontrolką. |
| UIA_IsKeyboardFocusablePropertyId | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| UIA_ItemStatusPropertyId | Zobacz uwagi. | Jeśli kontrolka zawiera stan aktualizowany dynamicznie, ta właściwość musi być obsługiwana, aby technologia pomocna mogła odbierać aktualizacje po zmianie stanu elementu. |
| UIA_ItemTypePropertyId | Zobacz uwagi. | Jest to wartość ciągu, która przekazuje użytkownikowi końcowemu obiekt źródłowy reprezentowany przez element. Przykłady obejmują "Plik multimedialny" i "Kontakt". |
| UIA_LabeledByPropertyId | Zero | Kontrolki elementów danych nie mają statycznej etykiety tekstowej. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający typowi kontrolki DataItem. Wartość domyślna to "element danych" dla en-US lub angielski (Stany Zjednoczone). |
| UIA_NamePropertyId | Zobacz uwagi. | Kontrolka elementu danych zawsze zawiera podstawowy element tekstowy, który użytkownik rozpozna jako identyfikator elementu. |
Wymagane wzorce kontrolek
W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi wszystkich kontrolek elementów danych. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie.
| Wzorzec kontrolki | Wsparcie | Notatki |
|---|---|---|
| IExpandCollapseProvider | Zależy | Jeśli element danych można rozwinąć lub zwinąć, aby pokazać i ukryć informacje, musi być obsługiwany wzorzec kontrolki ExpandCollapse. |
| IGridItemProvider | Zależy | Elementy danych będą obsługiwać wzorzec kontrolki GridItem, gdy kolekcja elementów danych jest dostępna w kontenerze, który może być w sposób przestrzenny nawigowany po elemencie-element. |
| IScrollItemProvider | Zależy | Wszystkie elementy danych obsługują możliwość przewijania do widoku za pomocą ScrollItem wzorca kontrolki, gdy ich kontener danych ma więcej elementów niż można zmieścić na ekranie. |
| ISelectionItemProvider | Zależy | Możliwość wybierania elementów danych zależy od zawartości. |
| ITableItemProvider | Zależy | Jeśli element danych znajduje się w DataGrid typ kontrolki, który ma element nagłówka, powinien obsługiwać wzorzec kontrolki TableItem. |
| IToggleProvider | Zależy | Jeśli element danych zawiera stan, który można przechodzić przez cykl, powinien obsługiwać wzorzec sterowania przełączania. |
| IValueProvider | Zależy | Jeśli podstawowy tekst elementu danych jest edytowalny, wzorzec kontrolki Wartość musi być obsługiwany. |
Praca z elementami DataItems na dużych listach
Ponieważ duże listy są często zwirtualizowane w strukturach interfejsu użytkownika, aby pomóc w wydajności, klient automatyzacji interfejsu użytkownika nie może używać funkcji zapytania automatyzacji interfejsu użytkownika do przeszukiwania zawartości pełnego drzewa w taki sam sposób, jak w innych kontenerach elementów. Klient powinien przewinąć element do widoku (lub rozwinąć kontrolkę, aby wyświetlić wszystkie dostępne opcje) przed uzyskaniem dostępu do pełnego zestawu informacji z elementu danych.
Podczas wywoływania SetFocus w elemencie automatyzacji interfejsu użytkownika dla elementu danych Eksplorator Microsoft Windows zwraca pomyślnie i powoduje ustawienie fokusu na kontrolkę Edytuj w poddrzewie elementu danych.
Zdarzenia wymagane
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika wymagane do obsługi kontrolek elementów danych. Aby uzyskać więcej informacji na temat zdarzeń, zobacz Omówienie zdarzeń automatyzacji interfejsu użytkownika.
| Zdarzenie automatyzacji interfejsu użytkownika | Notatki |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId zdarzenie zmienione właściwości. | |
| UIA_ExpandCollapseExpandCollapseStatePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki ExpandCollapse, musi obsługiwać to zdarzenie. |
| UIA_Invoke_InvokedEventId | Jeśli kontrolka obsługuje wzorzec kontrolki Invoke, musi obsługiwać to zdarzenie. |
| UIA_IsEnabledPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje właściwość IsEnabled, musi obsługiwać to zdarzenie. |
| UIA_IsOffscreenPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje właściwość IsOffscreen, musi obsługiwać to zdarzenie. |
| UIA_ItemStatusPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje właściwość ItemStatus, musi obsługiwać to zdarzenie. |
| UIA_NamePropertyId zdarzenie zmienione właściwości. | |
| UIA_SelectionItem_ElementAddedToSelectionEventId | Jeśli kontrolka obsługuje wzorzec kontrolki SelectionItem, musi obsługiwać to zdarzenie. |
| UIA_SelectionItem_ElementRemovedFromSelectionEventId | Jeśli kontrolka obsługuje wzorzec kontrolki SelectionItem, musi obsługiwać to zdarzenie. |
| UIA_SelectionItem_ElementSelectedEventId | Jeśli kontrolka obsługuje wzorzec kontrolki SelectionItem, musi obsługiwać to zdarzenie. |
| UIA_StructureChangedEventId | |
| UIA_ToggleToggleStatePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec sterowania przełącznika, musi obsługiwać to zdarzenie. |
| UIA_ValueValuePropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje wzorzec kontrolki Value, musi obsługiwać to zdarzenie. |
Przykładowy typ kontrolki DataItem
Na poniższej ilustracji przedstawiono typ kontrolki DataItem w kontrolce widoku listy.
Widok kontrolki i widok zawartości drzewa automatyzacji interfejsu użytkownika odnoszący się do kontrolki elementu danych jest wyświetlany poniżej. Wzorce sterowania dla każdego elementu automatyzacji są wyświetlane w nawiasach. Grupa "Contoso" jest również częścią siatki kontrolki hosta siatki danych. Aby zapoznać się z przykładem struktury siatki wyższego poziomu, zobacz Typ kontrolki DataGrid.
| Drzewo automatyzacji interfejsu użytkownika — widok sterowania | Drzewo automatyzacji interfejsu użytkownika — widok zawartości |
|---|---|
|
|
Jeśli siatka reprezentuje listę elementów, które można wybrać, odpowiednie elementy interfejsu użytkownika można uwidocznić za pomocą ListItem typ kontrolki zamiast typu kontrolki DataItem. W poprzednim przykładzie można ulepszyć elementy DataIt em ("Accounts Receivable.doc" i "Accounts Payable.doc") w obszarze Group ("Contoso"), ujawniając je jako typy kontrolek ListItem, ponieważ ten typ obsługuje już wzorzec SelectionItem.
Tematy pokrewne