Sdílet prostřednictvím

Implementace vzoru uživatelského rozhraní pro automatizaci ovládacích prvků výběru

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 ISelectionProvider, včetně informací o událostech a vlastnostech. Odkazy na další odkazy jsou uvedeny na konci tématu.

Vzor SelectionPattern ovládacího prvku podporuje ovládací prvky, které fungují jako kontejnery pro kolekci vybíratelných dětských položek. Podřízené položky tohoto prvku musí implementovat ISelectionItemProvider. Příklady ovládacích prvků, které implementují tento vzor ovládacího prvku, 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 kontroly výběru si všimněte následujících pokynů a konvencí:

  • Ovládací prvky, které implementují ISelectionProvider, umožňují výběr jedné nebo více podřízených položek. Například seznam, zobrazení seznamu a stromové zobrazení podporují více výběrů, zatímco pole se seznamem, posuvník a skupina přepínačů podporují jeden výběr.

  • Ovládací prvky s minimálním, maximálním a souvislým rozsahem, jako je například ovládací prvek Posuvník hlasitosti , by se 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í nebo ovládací prvek pro výběr barvy z Microsoft Wordu (viz níže), by měly implementovat ISelectionProvider; jejich podřízené prvky by měly implementovat obojí IRawElementProviderFragment i ISelectionItemProvider.

Výběr barvy se zvýrazněnou žlutou barvou Příklad mapování řetězců vzorníku barev

  • Nabídky nepodporují SelectionPattern. Pokud pracujete s položkami nabídky, které obsahují grafiku i text (například položky podokna náhledu v nabídce Zobrazení v Microsoft Outlooku) a potřebujete vyjádřit stav, měli byste implementovat IToggleProvider.

Požadované členy pro ISelectionProvider

Pro rozhraní jsou vyžadovány ISelectionProvider následující vlastnosti, metody a události.

Požadované členy Typ Poznámky
CanSelectMultiple Vlastnictví Mělo by podporovat události změny vlastností pomocí AddAutomationPropertyChangedEventHandler a RemoveAutomationPropertyChangedEventHandler.
IsSelectionRequired Vlastnictví Mělo by podporovat události změny vlastností pomocí AddAutomationPropertyChangedEventHandler a RemoveAutomationPropertyChangedEventHandler.
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í dalších událostí přidání a odebrání než InvalidateLimit konstantní povolení.

Vlastnosti 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ž IsSelectionRequired znamená 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.

Výjimky

Poskytovatelé musí vyvolat následující výjimky.

Typ výjimky Podmínka
ElementNotEnabledException Pokud ovládací prvek není povolený.
InvalidOperationException Pokud je ovládací prvek skrytý.

Viz také

  • Last updated on