Typ ovládacího prvku DataItem
Toto téma obsahuje informace o podpoře microsoft UI Automation pro typ ovládacího prvku DataItem.
Položka v seznamu kontaktů je příkladem ovládacího prvku datové položky. Ovládací prvek datové položky obsahuje informace, které jsou pro koncového uživatele zajímavé. Je složitější než jednoduchá položka seznamu, protože obsahuje bohatší informace.
Následující části definují požadovanou strukturu stromu automatizace uživatelského rozhraní, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku DataItem. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky datových položek, ve kterých architektura uživatelského rozhraní nebo platforma integruje podporu automatizace uživatelského rozhraní pro typy ovládacích prvků a vzory ovládacích prvků.
Toto téma obsahuje následující části.
- typické stromové struktury
- relevantních vlastností
- požadované vzory ovládacích prvků
- Práce s datovými daty ve velkých seznamech
- požadovaných událostí
- Příklad typu ovládacího prvku DataItem
- související témata
Typická stromová struktura
Následující tabulka znázorňuje typické zobrazení ovládacího prvku a obsahu stromu automatizace uživatelského rozhraní, které se týká ovládacích prvků datových položek a popisuje, co může být obsaženo v jednotlivých zobrazeních. Další informace o stromu automatizace uživatelského rozhraní naleznete v tématu přehled stromu automatizace uživatelského rozhraní.
| Zobrazení ovládacího prvku | Zobrazení obsahu |
|---|---|
|
|
Prvek datové položky v mřížce dat může hostovat celou řadu objektů, včetně jiné vrstvy datových položek nebo určitých prvků mřížky, jako je text, obrázky nebo ovládací prvky pro úpravy. Pokud prvek datové položky má určitou roli objektu, prvek by měl být vystaven jako konkrétní typ ovládacího prvku; Například typ ovládacího prvku ListItem pro vybratelnou datovou položku v mřížce.
Relevantní vlastnosti
Následující tabulka uvádí vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice jsou zvláště relevantní pro typ ovládacího prvku DataItem. Další informace o vlastnostech automatizace uživatelského rozhraní naleznete v tématu Načítání vlastností z prvků automatizace uživatelského rozhraní.
| Vlastnost automatizace uživatelského rozhraní | Hodnota | Poznámky |
|---|---|---|
| UIA_AutomationIdPropertyId | Viz poznámky. | Hodnota této vlastnosti musí být jedinečná mezi všemi partnerskými prvky v nezpracovaného zobrazení stromu automatizace uživatelského rozhraní. |
| UIA_BoundingRectanglePropertyId | Viz poznámky. | Vnější obdélník, který obsahuje celý ovládací prvek. |
| UIA_ClickablePointPropertyId | Viz poznámky. | Podporuje se, pokud existuje ohraničující obdélník. Pokud ne každý bod uvnitř ohraničujícího obdélníku je možné kliknout a prvek provádí specializované testování hitů, přepište a poskytněte kliknutelný bod. |
| UIA_ControlTypePropertyId | dataItem | |
| UIA_IsContentElementPropertyId | PRAVDIVÝ | Ovládací prvek datové položky musí být vždy obsahem. |
| UIA_IsControlElementPropertyId | PRAVDIVÝ | Ovládací prvek datové položky musí být vždy ovládací prvek. |
| UIA_IsKeyboardFocusablePropertyId | Viz poznámky. | Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat. |
| UIA_ItemStatusPropertyId | Viz poznámky. | Pokud ovládací prvek obsahuje stav, který se dynamicky aktualizuje, musí být tato vlastnost podporována, aby technologie usnadnění může přijímat aktualizace, když se stav prvku změní. |
| UIA_ItemTypePropertyId | Viz poznámky. | Toto je řetězcová hodnota, která koncovému uživateli předá podkladový objekt, který položka představuje. Mezi příklady patří "Mediální soubor" a "Kontakt". |
| UIA_LabeledByPropertyId | Nula | Ovládací prvky datových položek nemají statický textový popisek. |
| UIA_LocalizedControlTypePropertyId | Viz poznámky. | Lokalizovaný řetězec odpovídající typu ovládacího prvku DataItem. Výchozí hodnota je "položka dat" pro en-US nebo angličtinu (Spojené státy). |
| UIA_NamePropertyId | Viz poznámky. | Ovládací prvek datové položky vždy obsahuje primární textový prvek, který uživatel rozpozná jako identifikátor položky. |
Požadované vzory ovládacích prvků
V následující tabulce jsou uvedeny vzory ovládacích prvků automatizace uživatelského rozhraní, které musí být podporovány všemi ovládacími prvky datových položek. Další informace o vzorech ovládacích prvků najdete v tématu přehled vzorů ovládacích prvků automatizace uživatelského rozhraní.
| Vzor ovládacího prvku | Podpora | Poznámky |
|---|---|---|
| IExpandCollapseProvider | Závisí | Pokud lze datovou položku rozbalit nebo sbalit, aby se zobrazily a skrývaly informace, musí být podporován vzor ovládacích prvků ExpandCollapse. |
| IGridItemProvider | Závisí | Datové položky budou podporovat vzor ovládacího prvku GridItem, pokud je kolekce datových položek dostupná v kontejneru, který může být prostorově přecháděný mezi položkami. |
| IScrollItemProvider | Závisí | Všechny datové položky podporují možnost posouvání v zobrazení pomocí vzoru ovládacích prvků ScrollItem, pokud má jejich datový kontejner více položek, než se vejde na obrazovku. |
| ISelectionItemProvider | Závisí | Možnost výběru datových položek závisí na obsahu. |
| ITableItemProvider | Závisí | Pokud je datová položka obsažena v DataGrid typ ovládacího prvku, který má prvek záhlaví, měla by podporovat TableItem vzor ovládacího prvku. |
| IToggleProvider | Závisí | Pokud datová položka obsahuje stav, který lze cyklicky procházet, měl by podporovat Přepnout vzor ovládacího prvku. |
| IValueProvider | Závisí | Pokud je primární text datové položky upravitelný, musí být podporován vzor ovládacích prvků Hodnota. |
Práce s dataItems ve velkých seznamech
Vzhledem k tomu, že rozsáhlé seznamy jsou často virtualizovány v rámci architektur uživatelského rozhraní, aby pomohl s výkonem, nemůže klient automatizace uživatelského rozhraní použít funkci dotazu Automatizace uživatelského rozhraní k vyhledávání obsahu celého stromu stejným způsobem jako v jiných kontejnerech položek. Klient by se měl posouvat do zobrazení (nebo rozbalit ovládací prvek, aby se zobrazily všechny dostupné možnosti) před přístupem k úplné sadě informací z datové položky.
Při volání SetFocus u prvku Automatizace uživatelského rozhraní pro položku dat se Průzkumník Microsoft Windows úspěšně vrátí a způsobí, že fokus bude nastaven na ovládací prvek Upravit v podstromu datové položky.
Požadované události
Následující tabulka uvádí události automatizace uživatelského rozhraní, které ovládací prvky datových položek vyžadují pro podporu. Další informace o událostech najdete v tématu Přehled událostí automatizace uživatelského rozhraní.
| Událost automatizace uživatelského rozhraní | Poznámky |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId událost změněnou vlastností. | |
| UIA_ExpandCollapseExpandCollapseStatePropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje ExpandCollapse vzor ovládacího prvku, musí tuto událost podporovat. |
| UIA_Invoke_InvokedEventId | Pokud ovládací prvek podporuje vzor ovládacího prvku Invoke, musí tuto událost podporovat. |
| UIA_IsEnabledPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vlastnost IsEnabled, musí tuto událost podporovat. |
| UIA_IsOffscreenPropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vlastnost IsOffscreen, musí tuto událost podporovat. |
| UIA_ItemStatusPropertyId událost změny vlastnosti. | Pokud ovládací prvek podporuje vlastnost ItemStatus, musí tuto událost podporovat. |
| UIA_NamePropertyId událost změněnou vlastností. | |
| UIA_SelectionItem_ElementAddedToSelectionEventId | Pokud ovládací prvek podporuje vzor ovládacího prvku SelectionItem, musí tuto událost podporovat. |
| UIA_SelectionItem_ElementRemovedFromSelectionEventId | Pokud ovládací prvek podporuje vzor ovládacího prvku SelectionItem, musí tuto událost podporovat. |
| UIA_SelectionItem_ElementSelectedEventId | Pokud ovládací prvek podporuje vzor ovládacího prvku SelectionItem, musí tuto událost podporovat. |
| UIA_StructureChangedEventId | |
| UIA_ToggleToggleStatePropertyId událost změněnou vlastností. | Pokud ovládací prvek podporuje vzor ovládacích prvků Přepnout, musí tuto událost podporovat. |
| UIA_ValueValuePropertyId událost změny vlastnosti. | Pokud ovládací prvek podporuje vzor ovládacího prvku Hodnota, musí tuto událost podporovat. |
Příklad typu ovládacího prvku DataItem
Následující obrázek znázorňuje typ ovládacího prvku DataItem v ovládacím prvku zobrazení seznamu.
Zobrazení ovládacího prvku a zobrazení obsahu stromu automatizace uživatelského rozhraní, které se týká ovládacího prvku datové položky, se zobrazí níže. Vzory ovládacích prvků pro každý prvek automatizace jsou zobrazeny v závorkách. Skupina Contoso je také součástí mřížky ovládacího prvku hostitele datové mřížky. Příklad struktury mřížky vyšší úrovně naleznete v tématu Typ ovládacího prvku DataGrid.
| Strom automatizace uživatelského rozhraní – zobrazení ovládacího prvku | Strom automatizace uživatelského rozhraní – zobrazení obsahu |
|---|---|
|
|
Pokud mřížka představuje seznam položek s možností výběru, lze odpovídající vybratelné prvky uživatelského rozhraní vystavit pomocí typu ovládacího prvku ListItem typ ovládacího prvku místo typu ovládacího prvku DataItem. V předchozím příkladu lze prvky DataItem ("Accounts Receivable.doc" a "Accounts Payable.doc") v části Group ("Contoso") vylepšit jejich zveřejněním jako typy ovládacích prvků ListItem, protože tento typ již podporuje SelectionItem vzor ovládacího prvku.
Související témata