Implementace vzoru ovládacího prvku 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 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 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 ovládacích prvků SelectionItemPattern slouží 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 klienty automatizace uživatelského rozhraní.
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é ovládací prvky by měly implementovat IRawElementProviderFragment i 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 | Poznámky |
|---|---|---|
| CanSelectMultiple | Vlastnost | Žádný |
| IsSelectionRequired | Vlastnost | Žádný |
| GetSelection | Metoda | Žádný |
| 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ž povoluje konstanta InvalidateLimit. |
- Pokud je výsledkem Select, AddToSelectionnebo RemoveFromSelection jedna vybraná položka, měla by být vyvolána ElementSelectedEvent; jinak podle potřeby odešlete ElementAddedToSelectionEvent/ ElementRemovedFromSelectionEvent.
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 použita v kontejneru s jedním výběrem, kde IsSelectionRequiredProperty = true, a prvek je již zvolen.- RemoveFromSelection je volána v kontejneru s vícenásobným výběrem, kde IsSelectionRequiredProperty = true a 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ů automatizace uživatelského rozhraní
- Podpora vzorů ovládacích prvků v poskytovateli automatizace uživatelského rozhraní
- Vzory ovládacích prvků automatizace uživatelského rozhraní pro klienty
- Implementace vzoru ovládacích prvků pro automatizaci Uživatelského Rozhraní
- Přehled stromu automatizace uživatelského rozhraní
- Použití ukládání do mezipaměti v automatizaci uživatelského rozhraní
- Ukázka zprostředkovatele fragmentů