Podpora automatizace uživatelského rozhraní pro typ ovládacího prvku ComboBox

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 obsahuje informace o podpoře automatizace uživatelského rozhraní pro typ ovládacího prvku ComboBox. V automatizaci uživatelského rozhraní je typ ovládacího prvku sadou podmínek, které musí ovládací prvek splnit, aby bylo možné vlastnost použít ControlTypeProperty . Tyto podmínky zahrnují specifické pokyny pro stromovou strukturu automatizace uživatelského rozhraní, hodnoty vlastností automatizace uživatelského rozhraní, vzory ovládacích prvků a události automatizace uživatelského rozhraní.

Pole se seznamem je seznam v kombinaci se statickým ovládacím prvku nebo ovládacím prvku pro úpravy, který zobrazuje aktuálně vybranou položku v části seznamu pole se seznamem. Část ovládacího prvku seznam se zobrazí vždy nebo se zobrazí jenom v okamžiku, kdy uživatel vybere šipku rozevíracího seznamu (což je tlačítko push) vedle ovládacího prvku. Pokud je pole výběru ovládacím prvek pro úpravy, může uživatel zadat informace, které nejsou v seznamu; v opačném případě může uživatel vybrat pouze položky v seznamu.

Následující části definují požadovanou strukturu stromu automatizace uživatelského rozhraní, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku ComboBox. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky kombinovaného pole, ať už Windows Presentation Foundation (WPF), Win32 nebo Windows Forms.

Požadovaná struktura stromu automatizace uživatelského rozhraní

Následující tabulka znázorňuje zobrazení ovládacích prvků a zobrazení obsahu stromu automatizace uživatelského rozhraní, které se týká ovládacích prvků pole se seznamem, a popisuje, co může být obsaženo v jednotlivých zobrazeních. Další informace o stromu automatizace uživatelského rozhraní naleznete v tématu přehled stromu automatizace uživatelského rozhraní.

Zobrazení ovládacího prvku	Zobrazení obsahu
Rozevírací seznam - Upravit (0 nebo 1) - Seznam (1) - Položka seznamu (podřízená položka seznamu; 0 až n) - Tlačítko (1)	Rozevírací seznam - Položka seznamu (0 až několik)

Ovládací prvek pro úpravy v zobrazení kombinovaného pole je nutný pouze v případě, že kombinované pole lze upravit tak, aby umožnilo jakýkoli vstup, stejně jako v případě kombinovaného pole v dialogovém okně Spustit.

Požadované vlastnosti automatizace uživatelského rozhraní

Následující tabulka uvádí vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice jsou zvláště relevantní pro ovládací prvky pole se seznamem. Další informace o vlastnostech automatizace uživatelského rozhraní naleznete v tématu Vlastnosti automatizace uživatelského rozhraní pro klienty.

Vlastnost automatizace uživatelského rozhraní	Hodnota	Poznámky
AutomationIdProperty	Viz poznámky.	Hodnota této vlastnosti musí být jedinečná pro všechny ovládací prvky v aplikaci.
BoundingRectangleProperty	Viz poznámky.	Vnější obdélník, který obsahuje celý ovládací prvek.
ClickablePointProperty	Viz poznámky.	Podporuje se, pokud existuje ohraničující obdélník. Pokud není každý bod uvnitř ohraničujícího obdélníku kliknutelný a provádíte specializované testování zásahů, můžete přepsat a poskytnout kliknutelný bod.
ControlTypeProperty	Rozevírací seznam	Tato hodnota je stejná pro všechny architektury uživatelského rozhraní.
HelpTextProperty	Viz poznámky.	Text nápovědy pro ovládací prvky pole se seznamem by měl vysvětlit, proč se uživateli zobrazí výzva k výběru možnosti z pole se seznamem. Text se podobá informacím zobrazeným prostřednictvím popisu. Vyberte například položku, která nastaví rozlišení zobrazení monitoru.
IsContentElementProperty	Pravdivé	Ovládací prvky pole se seznamem jsou vždy zahrnuty do zobrazení obsahu stromu automatizace uživatelského rozhraní.
IsControlElementProperty	Pravdivé	Ovládací prvky pole se seznamem jsou vždy zahrnuty v zobrazení ovládacích prvků stromu automatizace uživatelského rozhraní.
IsKeyboardFocusableProperty	Pravdivé	Ovládací prvky kombinovaného pole zpřístupňují sadu položek z výběrového kontejneru. Ovládací prvek kombinovaného pole může přijímat fokus klávesnice, pokud klient automatizace uživatelského rozhraní nastaví fokus na kombinované pole, mohou dostat fokus některé položky v podstromu kombinovaného pole.
LabeledByProperty	Viz poznámky.	Ovládací prvky pole se seznamem obvykle mají statický textový popisek, na který tato vlastnost odkazuje.
LocalizedControlTypeProperty	kombinované pole	Lokalizovaný řetězec odpovídající typu ovládacího prvku ComboBox.
NameProperty	Viz poznámky.	Ovládací prvek pole se seznamem obvykle získá jeho název ze statického textového ovládacího prvku.

Požadované vzory ovládacích prvků automatizace uživatelského rozhraní

Následující tabulka uvádí vzory ovládacích prvků automatizace uživatelského rozhraní, které musí být podporovány všemi ovládacími prvky pole se seznamem. Další informace o vzorech ovládacích prvků najdete v tématu přehled vzorů ovládacích prvků automatizace uživatelského rozhraní.

Vzor ovládacího prvku	Podpora	Poznámky
IExpandCollapseProvider	Ano	Ovládací prvek pole se seznamem musí vždy obsahovat rozevírací tlačítko, aby to bylo pole se seznamem.
ISelectionProvider	Ano	Zobrazí aktuální výběr v poli se seznamem. Tato podpora je delegována do seznamového pole pod rozbalovacím seznamem.
IValueProvider	Závisí	Pokud má kombinované pole schopnost přijímat libovolné textové hodnoty, musí být podporován vzor hodnoty. Tento vzor umožňuje programově nastavit obsah textu v rozevíracím seznamu. Pokud vzor hodnoty není podporován, znamená to, že uživatel musí provést výběr položky ze seznamu v podstromu kombinovaného seznamu.
IScrollProvider	Nikdy	V kombinovaném poli se nikdy přímo nepodporuje rolovací vzor. Podporuje se, pokud může být seznamový box uvnitř komboboxu posouvatelný. Může se podporovat jenom v případech, kdy je seznam viditelný na obrazovce.

Požadované události

V následující tabulce jsou uvedeny události automatizace uživatelského rozhraní, které musí být podporovány všemi ovládacími prvky kombinovaného pole. Další informace o událostech najdete v tématu Přehled událostí automatizace uživatelského rozhraní.

Událost automatizace uživatelského rozhraní	Podpora	Poznámky
AutomationFocusChangedEvent	Povinné	Žádné
BoundingRectangleProperty událost změny vlastnosti.	Povinné	Žádné
IsOffscreenProperty událost změny vlastnosti.	Povinné	Žádné
IsEnabledProperty událost změny vlastnosti.	Povinné	Žádné
StructureChangedEvent	Povinné	Žádné
ExpandCollapseStateProperty událost změny vlastnosti.	Povinné	Žádné
ValueProperty událost změny vlastnosti.	Závisí	Pokud ovládací prvek podporuje model Hodnota, musí tuto událost podporovat.

Viz také

• ComboBox
• Přehled typů ovládacích prvků automatizace uživatelského rozhraní
• Přehled automatizace uživatelského rozhraní