Sdílet prostřednictvím


Typ ovládacího prvku Button

Toto téma obsahuje informace o podpoře microsoft UI Automation pro typ ovládacího prvku Button.

Tlačítko je objekt, se kterým uživatel pracuje, aby provedl nějakou akci, například tlačítka OK a Zrušit v dialogovém okně. Ovládací prvek tlačítka je jednoduchý ovládací prvek pro zveřejnění, protože se mapuje na jeden příkaz, který si uživatel přeje dokončit.

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 Button. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky tlačítek, 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é zobrazení ovládacího prvku a obsahu stromu automatizace uživatelského rozhraní, které se týká ovládacích prvků tlačítek, 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
  • Knoflík
    • Obrázek (0 nebo více)
    • Text (0 nebo více)
  • Knoflík

 

Relevantní vlastnosti

Následující tabulka uvádí vlastnosti automatizace uživatelského rozhraní, jejichž hodnota nebo definice jsou zvláště relevantní pro ovládací prvky, které implementují Button typ ovládacího prvku (například ovládací prvky tlačítka). 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_AcceleratorKeyPropertyId Viz poznámky. Ovládací prvek tlačítka obvykle podporuje klávesu akcelerátoru, která koncovému uživateli umožňuje rychle provést akci reprezentovanou tlačítkem z klávesnice.
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 tlačítka
UIA_HelpTextPropertyId Viz poznámky. Text nápovědy by měl znamenat, jaký bude konečný výsledek aktivace tlačítka. Obvykle se jedná o stejný typ informací zobrazených prostřednictvím popisu.
UIA_IsContentElementPropertyId PRAVDIVÝ Ovládací prvek tlačítka musí být vždy obsah.
UIA_IsControlElementPropertyId PRAVDIVÝ Ovládací prvek tlačítka musí být vždy ovládací prvek.
UIA_IsKeyboardFocusablePropertyId Viz poznámky. Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat.
UIA_LabeledByPropertyId Nula Ovládací prvky tlačítek jsou označené svým obsahem.
UIA_LocalizedControlTypePropertyId Viz poznámky. Lokalizovaný řetězec odpovídající typu ovládacího prvku Button. Výchozí hodnota je "button" pro en-US nebo angličtinu (Spojené státy).
UIA_NamePropertyId Viz poznámky. Název ovládacího prvku tlačítka je text, který se používá k označení. Při každém použití obrázku k označení tlačítka musí být pro vlastnost název tlačítka zadán alternativní text.

 

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 tlačítek. Další informace o vzorech ovládacích prvků najdete v tématu přehled vzorů ovládacích prvků automatizace uživatelského rozhraní.

Vlastnost vzoru ovládacího prvku nebo vzoru Podpora/hodnota Poznámky
IExpandCollapseProvider Viz poznámky. Pokud je tlačítko hostované jako podřízené tlačítko rozdělení, podřízené tlačítko může podporovat ExpandCollapse vzor ovládacího prvku namísto Vyvolat nebo Přepnout vzor ovládacího prvku. Vzor ovládacího prvku ExpandCollapse lze použít k otevření nebo zavření nabídky nebo jiné dílčí struktury přidružené k prvku button.
IInvokeProvider Viz poznámky. Všechna tlačítka by měla podporovat vzor ovládacího prvku Vyvolat nebo Přepnout vzor ovládacího prvku, ale ne obojí. Vzorec ovládacího prvku Vyvolat musí být podporován, když tlačítko provede příkaz na žádost uživatele. Tento příkaz se mapuje na jednu operaci, jako je vyjmutí, kopírování, vložení nebo odstranění.
IToggleProvider Viz poznámky. Všechna tlačítka by měla podporovat vzor ovládacího prvku Vyvolat nebo Přepnout vzor ovládacího prvku, ale ne obojí. Pokud tlačítko může cyklicky procházet řadou až tří stavů, musí být podporováno ovládací schéma Přepínací tlačítko. Obvykle se to považuje za přepínač zapnuto/vypnuto pro konkrétní funkce.

 

Požadované události

Následující tabulka uvádí události automatizace uživatelského rozhraní, které ovládací prvky tlačítek vyžadují 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_Invoke_InvokedEventId Pokud ovládací prvek podporuje vzor ovládacího prvku Invoke, musí tuto událost podporovat.
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_NamePropertyId událost změněnou vlastností.
UIA_StructureChangedEventId
UIA_ToggleToggleStatePropertyId událost změněnou vlastností. Pokud ovládací prvek podporuje vzor ovládacích prvků Přepnout, 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í