Podpora automatizace uživatelského rozhraní pro typ ovládacího prvku tlačítko

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 Tlačítko. 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í.

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, 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ů 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

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, které implementují typ ovládacího prvku Button (například ovládací prvky tlačítka). 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
AcceleratorKeyProperty	Viz poznámky.	Ovládací prvek Button obvykle musí podporovat klávesu akcelerátoru, aby koncový uživatel mohl provést akci, kterou představuje rychle z klávesnice.
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	Knoflík	Tato hodnota je stejná pro všechny architektury uživatelského rozhraní.
HelpTextProperty	Viz poznámky.	Text nápovědy může indikovat, jaký bude konečný výsledek aktivace tlačítka. Obvykle se jedná o stejný typ informace, který se zobrazuje prostřednictvím popisu.
IsContentElementProperty	Pravdivé	Ovládací prvek tlačítka musí vždy obsahovat obsah.
IsControlElementProperty	Pravdivé	Ovládací prvek Tlačítko musí být vždy ovládacím prvkem.
IsKeyboardFocusableProperty	Viz poznámky.	Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat.
LabeledByProperty	Null	Ovládací prvky tlačítek jsou označené svým obsahem.
LocalizedControlTypeProperty	tlačítko	Lokalizovaný řetězec odpovídající typu ovládacího prvku Button.
NameProperty	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ů 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 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í.

Vzor ovládacího prvku	Podpora	Poznámky
IInvokeProvider	Viz poznámky.	Všechna tlačítka by měla podporovat ovládací vzor pro vyvolání nebo přepnutí. Vyvolání se podporuje, 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 ovládací vzor pro vyvolání nebo přepnutí. Přepínač se podporuje, pokud je možné tlačítko cyklicky procházet řadou až tří stavů. Obvykle se to považuje za přepínač zapnuto/vypnuto pro konkrétní funkce.
IExpandCollapseProvider	Viz poznámky.	Pokud je tlačítko umístěné jako podřízené rozdělovací tlačítko, podřízené tlačítko může podporovat vzor ExpandCollapse místo vzoru Invoke nebo Toggle. Vzor ExpandCollapse lze použít k otevření nebo zavření nabídky nebo jiné dílčí struktury přidružené k prvku button.

Požadované události automatizace uživatelského rozhraní

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 tlačítek. 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é
NameProperty událost změny vlastnosti.	Povinné	Žádné
StructureChangedEvent	Povinné	Žádné
InvokedEvent	Závisí	Pokud ovládací prvek podporuje vzor ovládacího prvku Invoke, musí tuto událost podporovat.
ToggleStateProperty událost změny vlastnosti.	Závisí	Pokud ovládací prvek podporuje přepínací vzor ovládání, musí tuto událost podporovat.

Viz také

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