Vzor ovládacího prvku výběru
Popisuje pokyny a konvence pro implementaci ISelectionProvider, včetně informací o vlastnostech, metodách a událostech. Vzor ovládacího prvku Selection slouží k podpoře ovládacích prvků, které fungují jako kontejnery pro kolekci volitelných podřízených položek. Podřízené položky tohoto prvku musí implementovat ISelectionItemProvider.
Příklady ovládacích prvků, které tento vzor ovládacích prvků implementují, najdete v tématu typy ovládacích prvků a jejich podporované vzory ovládacích prvků.
Toto téma obsahuje následující části.
Pokyny a konvence implementace
Při implementaci vzoru kontroly výběr si všimněte následujících pokynů a konvencí:
Ovládací prvky, které implementují ISelectionProvider umožňují vybrat jednu nebo více podřízených položek. Například seznamy, zobrazení seznamů a stromová zobrazení podporují více výběrů, zatímco pole se seznamem, posuvníky a skupiny přepínačů podporují jeden výběr.
Ovládací prvky, které mají minimální, maximální a souvislý rozsah, například ovládací prvek posuvníku Hlasitost přehrávač médií, by měly implementovat IRangeValueProvider místo ISelectionProvider.
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í pro Windows nebo ovládací prvek pro výběr barvy ovládací prvek výběru z Microsoft Wordu (viz následující obrázek), by měl implementovat ISelectionProvider; jejich děti by měly implementovat IRawElementProviderFragment i ISelectionItemProvider.
Nabídky nepodporují vzor ovládacích prvků výběr. Pokud pracujete s položkami nabídky, které obsahují grafiku i text (například podokno náhledu položky v nabídce Zobrazení v Aplikaci Microsoft Outlook) a potřebujete vyjádřit stav, měli byste implementovat IToggleProvider.
Požadované členy pro ISelectionProvider
Pro implementaci rozhraní ISelectionProvider jsou 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ý |
| UIA_Selection_InvalidatedEventId | Událost | Vyvolání této události v případě, že se výrazně změnil výběr v kontejneru. |
Vlastnosti ISelectionProvider::IsSelectionRequired a CanSelectMultiple vlastnosti mohou být dynamické. Například počáteční stav ovládacího prvku nemusí mít ve výchozím nastavení vybrané žádné položky, což znamená, že IsSelectionRequired je false. Po výběru položky však musí mít ovládací prvek vždy alespoň jednu vybranou položku. Podobně může ovládací prvek ve výjimečných případech povolit, aby při inicializaci bylo vybráno více položek, ale následně je možné provést pouze jednotlivé výběry.
Související témata
-
typy ovládacích prvků a jejich podporované vzory ovládacích prvků
-
Přehled vzorů ovládacích prvků automatizace uživatelského rozhraní