Podpora automatizace uživatelského rozhraní pro typ ovládacího prvku DataItem

Poznámka:

Tato dokumentace je určená pro vývojáře rozhraní .NET Framework, kteří chtějí používat spravované třídy automatizace uživatelského rozhraní definované v oboru názvů System.Windows.Automation. Nejnovější informace o automatizaci uživatelského rozhraní najdete v tématu rozhraní API služby Windows Automation: Automatizace uživatelského rozhraní.

Toto téma obsahuje informace o podpoře automatizace uživatelského rozhraní Microsoftu pro typ ovládacího prvku DataItem. V automatizaci uživatelského rozhraní je typ ovládacího prvku sada podmínek, které musí ovládací prvek splnit, aby bylo možné tuto vlastnost použít ControlTypeProperty . Podmínky zahrnují specifické pokyny pro strukturu stromu automatizace uživatelského rozhraní, hodnoty vlastností automatizace uživatelského rozhraní a vzory ovládacích prvků.

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, ať už windows Presentation Foundation (WPF), Win32 nebo Windows Forms.

Požadovaná struktura stromu automatizace uživatelského rozhraní

Následující tabulka znázorňuje zobrazení ovládacích prvků a zobrazení 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í.

Strom automatizace uživatelského rozhraní – zobrazení ovládacího prvku	Strom automatizace uživatelského rozhraní – zobrazení obsahu
DataItem – Liší se (0 nebo více; může být strukturována v hierarchii)	DataItem – Liší se (0 nebo více; může být strukturována v hierarchii)

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.

Požadované vlastnosti automatizace uživatelského rozhraní

Následující tabulka uvádí vlastnosti, jejichž hodnota nebo definice jsou zvláště relevantní pro ovládací prvky datové položky. Další informace o vlastnostech automatizace uživatelského rozhraní naleznete v tématu Vlastnosti automatizace uživatelského rozhraní pro klienty.

Vlastnictví	Hodnota	Poznámky
AutomationIdProperty	Viz poznámky.	Hodnota této vlastnosti musí být jedinečná pro všechny ovládací prvky v aplikaci.
BoundingRectangleProperty	Viz poznámky.	Vnější obdélník, který obsahuje celý ovládací prvek.
ClickablePointProperty	Viz poznámky.	Podporuje se, pokud existuje ohraničující obdélník. Pokud není každý bod uvnitř ohraničujícího obdélníku kliknutelný a provádíte specializované testování zásahů, můžete přepsat a poskytnout kliknutelný bod.
ControlTypeProperty	DataItem	Tato hodnota je stejná pro všechny architektury uživatelského rozhraní.
IsContentElementProperty	Pravdivé	Ovládací prvek datové položky musí být vždy obsahem.
IsControlElementProperty	Pravdivé	Ovládací prvek datové položky musí být vždy ovládací prvek.
IsKeyboardFocusableProperty	Viz poznámky.	Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat.
ItemStatusProperty	Viz poznámky.	Pokud ovládací prvek obsahuje stav, který se aktualizuje dynamicky, musí být tato vlastnost podporována, aby technologie usnadnění může přijímat aktualizace při změně stavu prvku.
ItemTypeProperty	Viz poznámky.	Toto je řetězcová hodnota, která koncovému uživateli předá podkladový objekt, který položka představuje. Příklady jsou "Multimediální soubor" nebo "Kontakt".
LabeledByProperty	Null	Ovládací prvky datových položek nemají statický textový popisek.
LocalizedControlTypeProperty	"datová položka"	Lokalizovaný řetězec odpovídající typu ovládacího prvku DataItem.
NameProperty	Viz poznámky.	Ovládací prvek datové položky vždy obsahuje primární textový prvek, který se vztahuje k tomu, co by uživatel přidružil jako sémantický identifikátor položky.

Požadované vzory ovládacích prvků automatizace uživatelského rozhraní

Následující tabulka uvádí vzory ovládacích prvků Microsoft UI Automation, které musí podporovat všechny ovládací prvky datových položek. Další informace o vzorech ovládacích prvků naleznete 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 je možné datovou položku rozbalit nebo sbalit, aby se zobrazily a skrývaly informace, musí být podporován rozbalovací a sbalovací vzor.
IGridItemProvider	Závisí	Datové položky budou podporovat vzor položky mřížky, pokud je kolekce datových položek dostupná v kontejneru, který může být prostorově přecházený mezi položkami.
IScrollItemProvider	Závisí	Všechny datové položky podporují možnost posouvání v zobrazení se vzorem Posunout položku, pokud má jejich datový kontejner více položek, než se vejde na obrazovku.
ISelectionItemProvider	Ano	Všechny datové položky musí podporovat vzorec pro výběr položky, aby bylo možné určit, kdy je položka vybrána.
ITableItemProvider	Závisí	Pokud je datová položka obsažena v ovládacím typu Datové mřížky, bude tento vzor podporovat.
IToggleProvider	Závisí	Pokud datová položka obsahuje stav, který lze cyklicky procházet.
IValueProvider	Závisí	Pokud je primární text datové položky upravitelný, musí být podporován vzor hodnoty.

Práce s datovými položkami ve velkých seznamech

Velké seznamy jsou často data virtualizovaná v rámci architektur uživatelského rozhraní, která pomáhají s výkonem. Z tohoto důvodu nemůže klient automatizace uživatelského rozhraní použít funkci dotazu Automatizace uživatelského rozhraní k výstřižku obsahu celého stromu stejným způsobem jako v jiných kontejnerech položek. Klient by měl položku posunout do zobrazení (nebo rozbalit ovládací prvek, aby se zobrazily všechny cenné možnosti) dříve, než získá přístup k úplné sadě informací z datové položky.

Při volání SetFocus prvku Automatizace uživatelského rozhraní pro položku dat se případ Microsoft Windows Exploreru úspěšně vrátí a fokus bude nastaven na položku Upravit v podstromu datové položky.

Požadované události automatizace uživatelského rozhraní

V následující tabulce jsou uvedeny události automatizace uživatelského rozhraní, které musí být podporovány všemi ovládacími prvky datových položek. Další informace o událostech naleznete v tématu Přehled událostí automatizace uživatelského rozhraní.

Událost automatizace uživatelského rozhraní	Podpora	Poznámky
AutomationFocusChangedEvent	Povinné	Žádné
BoundingRectangleProperty událost změny vlastnosti.	Povinné	Žádné
IsEnabledProperty událost změny vlastnosti.	Povinné	Žádné
IsOffscreenProperty událost změny vlastnosti.	Povinné	Žádné
NameProperty událost změny vlastnosti.	Povinné	Žádné
StructureChangedEvent	Povinné	Žádné
InvokedEvent	Závisí	Žádné
ExpandCollapseStateProperty událost změny vlastnosti.	Závisí	Žádné
ElementAddedToSelectionEvent	Povinné	Žádné
ElementRemovedFromSelectionEvent	Povinné	Žádné
ElementSelectedEvent	Povinné	Žádné
ToggleStateProperty událost změny vlastnosti.	Závisí	Žádné
ValueProperty událost změny vlastnosti.	Závisí	Žádné

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 s podporou bohatých informací pro sloupce.

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 hostitelského ovládacího prvku datové mřížky.

Strom automatizace uživatelského rozhraní – zobrazení ovládacího prvku

Strom automatizace uživatelského rozhraní – zobrazení obsahu

– Skupina Contoso (tabulka, mřížka) – Datová položka "Pohledávky.doc" (Položka tabulky, Položka mřížky, Položka výběru, Vyvolat) – Obrázek "Účty Receivable.doc" - Upravit "Název" (TableItem, GridItem, Value "Accounts Receivable.doc") - Upravit "Datum změny" (TableItem, GridItem, Hodnota "25.8.2006 15:29") - Upravit "Velikost" (GridItem, TableItem, Hodnota "11,0 kB) – DataItem "Závazky.doc" (TableItem, GridItem, SelectionItem, Invoke) - ...

– Skupina Contoso (tabulka, mřížka) – Datová položka "Pohledávky.doc" (Položka tabulky, Položka mřížky, Položka výběru, Vyvolat) – Obrázek "Účty Receivable.doc" - Upravit "Název" (TableItem, GridItem, Value "Accounts Receivable.doc") - Upravit "Datum změny" (TableItem, GridItem, Hodnota "25.8.2006 15:29") - Upravit "Velikost" (GridItem, TableItem, Hodnota "11,0 kB) – DataItem "Závazky.doc" (TableItem, GridItem, SelectionItem, Invoke) - …

Pokud mřížka představuje seznam položek, které lze vybrat, mohou být odpovídající prvky uživatelského rozhraní vystaveny s typem ovládacího prvku ListItem namí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 vzor ovládacího prvku SelectionItem.

Viz také

• DataItem
• Přehled typů ovládacích prvků automatizace uživatelského rozhraní
• Přehled automatizace uživatelského rozhraní