Sdílet prostřednictvím

Typ ovládacího prvku ComboBox

  • Článek

Toto téma obsahuje informace o podpoře automatizace uživatelského rozhraní microsoftu pro typ ovládacího prvku ComboBox.

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 Combo Box. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky pole se seznamem, ve kterých architektura uživatelského rozhraní nebo platforma integruje podporu automatizace uživatelského rozhraní pro typy ovládacích prvků a vzory ovládacích prvků.

Toto téma obsahuje následující části.

Typická stromová struktura

Následující tabulka znázorňuje typické ovládací prvky 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
  • Pole se seznamem
    • Upravit (0 nebo 1)
    • Seznam (0 nebo 1)
    • Položka seznamu (podřízená položka seznamu; 0 až mnoho)
    • Tlačítko (1)
  • Pole se seznamem
    • 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.

Relevantní vlastnosti

Následující tabulka uvádí vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice jsou zvláště relevantní pro typ ovládacího prvku ComboBox. Další informace o vlastnostech automatizace uživatelského rozhraní naleznete v tématu Načítání vlastností z prvků automatizace uživatelského rozhraní.

Vlastnost automatizace uživatelského rozhraní Hodnota Poznámky
UIA_AutomationIdPropertyId Viz poznámky. Hodnota této vlastnosti musí být jedinečná mezi všemi partnerskými prvky v nezpracovaného zobrazení stromu automatizace uživatelského rozhraní.
UIA_BoundingRectanglePropertyId Viz poznámky. Vnější obdélník, který obsahuje celý ovládací prvek.
UIA_ClickablePointPropertyId 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 prvek provádí specializované testování hitů, přepište a poskytněte kliknutelný bod.
UIA_ControlTypePropertyId Pole se seznamem
UIA_HelpTextPropertyId 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, vybrat z pole se seznamem možnost. Text se podobá informacím zobrazeným prostřednictvím popisu. Vyberte například položku, která nastaví rozlišení zobrazení monitoru.
UIA_IsContentElementPropertyId PRAVDIVÝ Ovládací prvky pole se seznamem jsou vždy zahrnuty do zobrazení obsahu stromu automatizace uživatelského rozhraní.
UIA_IsControlElementPropertyId PRAVDIVÝ Ovládací prvky pole se seznamem jsou vždy zahrnuty v zobrazení ovládacích prvků stromu automatizace uživatelského rozhraní.
UIA_IsKeyboardFocusablePropertyId PRAVDIVÝ Ovládací prvky pole se seznamem mohou přijímat fokus klávesnice; Pokud ale klient automatizace uživatelského rozhraní nastaví fokus na pole se seznamem, může se fokus zobrazit libovolnou položkou v podstromu pole se seznamem.
UIA_LabeledByPropertyId Viz poznámky. Ovládací prvky pole se seznamem obvykle mají statický textový popisek, na který tato vlastnost odkazuje.
UIA_LocalizedControlTypePropertyId Viz poznámky. Lokalizovaný řetězec odpovídající typu ovládacího prvku ComboBox. Výchozí hodnota je pole se seznamem pro en-US nebo angličtinu (Spojené státy).
UIA_NamePropertyId Viz poznámky. Název ovládacího prvku pole se seznamem se obvykle generuje ze statického textového popisku. Pokud není popisek statického textu, musíte přiřadit hodnotu vlastnosti Name. Vlastnost Název by nikdy neměla obsahovat aktuální obsah pole se seznamem ani při změně obsahu pole se seznamem.

 

Požadované vzory ovládacích prvků

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 Požadovaný Ovládací prvek ExpandCollapse musí být podporován, protože ovládací prvek pole se seznamem musí vždy obsahovat rozevírací tlačítko.
ISelectionProvider Závisí Zobrazí aktuální výběr v poli se seznamem. Podpora vzoru ovládacích prvků výběr se deleguje do seznamu pod polem se seznamem, ale nemusí být vždy proveditelné.
IValueProvider Závisí Pokud pole se seznamem může obsahovat libovolné textové hodnoty, musí být podporován vzor ovládacího prvku Hodnota. Tento vzor umožňuje programově nastavit obsah řetězce pole se seznamem. Pokud vzor ovládacího prvku Hodnota není podporován, uživatel musí vybrat položky seznamu v podstromu pole se seznamem.
IScrollProvider Nikdy Vzor ovládacího prvku Scroll není nikdy podporován přímo v poli se seznamem. Podporuje se, pokud se seznam obsažený v poli se seznamem může posunout a pouze v případě, že je seznam viditelný na obrazovce.

 

Požadované události

V následující tabulce jsou uvedeny události automatizace uživatelského rozhraní, které ovládací prvky pole se seznamem jsou vyžadovány pro podporu. 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í Poznámky
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId událost změněnou vlastností.
UIA_IsEnabledPropertyId událost změněnou vlastností. Pokud ovládací prvek podporuje vlastnost IsEnabled, musí tuto událost podporovat.
UIA_IsOffscreenPropertyId událost změněnou vlastností. Pokud ovládací prvek podporuje vlastnost IsOffscreen, musí tuto událost podporovat.
UIA_StructureChangedEventId
UIA_ExpandCollapseExpandCollapseStatePropertyId událost změněnou vlastností.
UIA_ValueValuePropertyId událost změny vlastnosti. Pokud ovládací prvek podporuje vzor ovládacího prvku Hodnota, musí tuto událost podporovat.

 

koncepční

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

Přehled automatizace uživatelského rozhraní