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 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 obsahuje informace o podpoře model UI Automation pro typ ovládacího prvku ComboBox. V model UI Automation je typ ovládacího prvku sadou podmínek, které musí ovládací prvek splňovat, aby bylo možné vlastnost použítControlTypeProperty. Mezi tyto podmínky patří specifické pokyny pro strukturu stromové struktury model UI Automation, hodnoty vlastností model UI Automation, vzory ovládacích prvků a události model UI Automation.
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 model UI Automation stromovou strukturu, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku ComboBox. Požadavky na model UI Automation platí pro všechny ovládací prvky pole se seznamem, ať už windows Presentation Foundation (WPF), Win32 nebo model Windows Forms.
Požadovaná struktura stromu model UI Automation
Následující tabulka znázorňuje zobrazení ovládacích prvků a zobrazení obsahu stromu model UI Automation, 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 model UI Automation najdete v tématu model UI Automation Stromový přehled.
| Zobrazení ovládacího prvku | Zobrazení obsahu |
|---|---|
| ComboBox - Upravit (0 nebo 1) - Seznam (1) - Položka seznamu (podřízená položka seznamu; 0 až n) - Tlačítko (1) |
ComboBox - Položka seznamu (0 až mnoho) |
Ovládací prvek pro úpravy v zobrazení ovládacího prvku pole se seznamem je nutný pouze v případě, že pole se seznamem lze upravit tak, aby převzalo jakýkoli vstup, stejně jako v případě pole se seznamem v dialogovém okně Spustit.
Požadované vlastnosti model UI Automation
V následující tabulce jsou uvedeny vlastnosti model UI Automation, jejichž hodnota nebo definice jsou zvláště relevantní pro ovládací prvky pole se seznamem. Další informace o model UI Automation vlastnosti naleznete v tématu model UI Automation Vlastnosti pro klienty.
| vlastnost model UI Automation | Hodnota | Notes |
|---|---|---|
| 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 ne každý bod uvnitř ohraničujícího obdélníku je možné kliknout a provést specializované testování hitů, pak přepsat a poskytnout kliknutelný bod. |
| ControlTypeProperty | ComboBox | 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 | True | Ovládací prvky pole se seznamem jsou vždy zahrnuty v zobrazení obsahu stromu model UI Automation. |
| IsControlElementProperty | True | Ovládací prvky pole se seznamem jsou vždy zahrnuty v zobrazení ovládacího prvku stromu model UI Automation. |
| IsKeyboardFocusableProperty | True | Ovládací prvky pole se seznamem zpřístupňují sadu položek z kontejneru výběru. Ovládací prvek pole se seznamem může přijímat fokus klávesnice, i když model UI Automation klient nastaví fokus na pole se seznamem, můžou se fokus zobrazit všechny položky v podstromu pole se seznamem. |
| LabeledByProperty | Viz poznámky. | Ovládací prvky pole se seznamem obvykle mají statický textový popisek, na který tato vlastnost odkazuje. |
| LocalizedControlTypeProperty | "Pole se seznamem" | 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ů model UI Automation
V následující tabulce jsou uvedeny vzory ovládacích prvků model UI Automation, 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 model UI Automation Přehled vzorů ovládacích prvků.
| Vzor ovládacího prvku | Technická podpora | Notes |
|---|---|---|
| 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 se deleguje do seznamu pod polem se seznamem. |
| IValueProvider | Závisí | Pokud má pole se seznamem možnost přijímat libovolné textové hodnoty, musí být podporován vzor Hodnota. Tento model poskytuje možnost programově nastavit obsah řetězce pole se seznamem. Pokud vzor hodnoty není podporovaný, znamená to, že uživatel musí vybrat položky seznamu v podstromu pole se seznamem. |
| IScrollProvider | Nikdy | V poli se seznamem se nikdy nepodporuje vzor posouvání. Podporuje se, pokud se seznam obsahuje v poli se seznamem, který se může posunout. Může se podporovat jenom v případech, kdy je seznam viditelný na obrazovce. |
Požadované události
Následující tabulka uvádí model UI Automation události, které musí být podporovány všemi ovládacími prvky pole se seznamem. Další informace o událostech najdete v tématu model UI Automation Přehled událostí.
| událost model UI Automation | Technická podpora | Notes |
|---|---|---|
| AutomationFocusChangedEvent | Požaduje se | Nic |
| BoundingRectangleProperty událost změněná vlastností. | Požaduje se | Nic |
| IsOffscreenProperty událost změněná vlastností. | Požaduje se | Nic |
| IsEnabledProperty událost změněná vlastností. | Požaduje se | Nic |
| StructureChangedEvent | Požaduje se | Nic |
| ExpandCollapseStateProperty událost změněná vlastností. | Požaduje se | Nic |
| ValueProperty událost změněná vlastností. | Závisí | Pokud ovládací prvek podporuje model Hodnota, musí tuto událost podporovat. |