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é struktury
- relevantních vlastností
- požadované vzory ovládacích prvků
- požadovaných událostí
- související témata
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 |
---|---|
|
|
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. |
Související témata