Share via

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

  • Článek

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 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 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í, naleznete v tématu Mapování vzorů ovládacích prvků pro model UI Automation Klienti.

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 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.

Color picker with yellow highlighted. 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 Notes
CanSelectMultiple Vlastnost Mělo by podporovat události změny vlastností pomocí AddAutomationPropertyChangedEventHandler a RemoveAutomationPropertyChangedEventHandler.
IsSelectionRequired Vlastnost Mělo by podporovat události změny vlastností pomocí AddAutomationPropertyChangedEventHandler a RemoveAutomationPropertyChangedEventHandler.
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í 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é