Implementace vzoru ovládacích prvků SelectionItem pro automatizaci uživatelského rozhraní
Poznámka:
Tato dokumentace je určená pro vývojáře rozhraní .NET Framework, kteří chtějí používat spravované třídy model UI Automation definované v System.Windows.Automation oboru názvů. Nejnovější informace o model UI Automation najdete v tématu Rozhraní API služby Windows Automation: model UI Automation.
Toto téma představuje pokyny a konvence pro implementaci ISelectionItemProvider, včetně informací o vlastnostech, metodách a událostech. Odkazy na další odkazy jsou uvedeny na konci přehledu.
Vzor SelectionItemPattern ovládacích prvků se používá k podpoře ovládacích prvků, které fungují jako jednotlivé, vybratelné podřízené položky ovládacích prvků kontejneru, které implementují ISelectionProvider. Příklady ovládacích prvků, které implementují vzor ovládacího prvku SelectionItem, naleznete v tématu Mapování vzorů ovládacích prvků pro model UI Automation Klienti.
Pokyny a konvence implementace
Při implementaci vzoru ovládacího prvku Položka výběru si všimněte následujících pokynů a konvencí:
- Ovládací prvky s jedním výběrem, které spravují podřízené ovládací prvky, které implementují IRawElementProviderFragmentRoot, například posuvník Rozlišení obrazovky v dialogovém okně Vlastnosti zobrazení, by měly implementovat ISelectionProvider a jejich podřízené prvky by měly implementovat obě IRawElementProviderFragment a ISelectionItemProvider.
Požadované členy pro ISelectionItemProvider
Pro implementaci ISelectionItemProviderjsou vyžadovány následující vlastnosti, metody a události .
| Požadované členy | Typ členu | Notes |
|---|---|---|
| CanSelectMultiple | Vlastnost | Nic |
| IsSelectionRequired | Vlastnost | Nic |
| GetSelection | metoda | Nic |
| InvalidatedEvent | Událost | Vyvolá se, když se výběr v kontejneru výrazně změnil a vyžaduje odesílání více ElementSelectedEvent a ElementRemovedFromSelectionEvent událostí než InvalidateLimit konstantní povolení. |
- Pokud je výsledkem Select, nebo AddToSelectionnebo RemoveFromSelection je jedna vybraná položka, ElementSelectedEvent měla by být vyvolána; jinak odeslat ElementAddedToSelectionEvent/ ElementRemovedFromSelectionEvent podle potřeby.
Výjimky
Poskytovatelé musí vyvolat následující výjimky.
| Typ výjimky | Podmínka |
|---|---|
| InvalidOperationException | Při pokusu o provedení některého z následujících kroků: - RemoveFromSelection je volána v kontejneru s jedním výběrem, kde IsSelectionRequiredProperty = true a prvek je již vybrán.- RemoveFromSelection je volána v kontejneru s vícenásobným výběrem, kde IsSelectionRequiredProperty = true je vybrán pouze jeden prvek.- AddToSelection je volána v kontejneru s jedním výběrem, kde CanSelectMultipleProperty = false a další prvek je již vybrán. |
Viz také
- Přehled vzorů ovládacích prvků pro automatizaci uživatelského rozhraní
- Podpora vzorů ovládacích prvků u zprostředkovatele automatizace uživatelského rozhraní
- Vzory ovládacích prvků automatizace uživatelského rozhraní pro klienty
- Implementace vzoru ovládacích prvků výběr pro automatizaci uživatelského rozhraní
- Přehled stromu automatizace uživatelského rozhraní
- Použití mezipaměti při automatizaci uživatelského rozhraní
- Ukázka zprostředkovatele fragmentů