Podpora automatizace uživatelského rozhraní pro typ ovládacího prvku SplitButton

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 SplitButton. 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 . Podmínky zahrnují specifické pokyny pro strukturu stromu automatizace uživatelského rozhraní, hodnoty vlastností automatizace uživatelského rozhraní a vzory ovládacích prvků.

Ovládací prvek pro rozdělení tlačítka umožňuje provést akci na ovládacím prvku a rozbalit jej, a zobrazit seznam dalších možných akcí, které lze provést.

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 SplitButton. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky rozdělitelných 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ů rozdělených 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
Rozdělovací tlačítko Obrázek (0 nebo 1) Text (0 nebo 1) Tlačítko (1 nebo 2) Nabídka (0 nebo 1; zobrazí se jako podřízené tlačítko, které podporuje vzor ExpandCollapse) MenuItem (1 až mnoho)	Rozdělovací tlačítko - MenuItem (1 až mnoho)

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 rozdělení ovládacích prvků tlačítek. 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
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.
IsKeyboardFocusableProperty	Viz poznámky.	Pokud ovládací prvek může přijímat fokus klávesnice, musí tuto vlastnost podporovat.
NameProperty	"Zpět"	Název ovládacího prvku split button se zobrazí na tlačítku.
LabeledByProperty	Nula	Ovládací prvky tlačítka Rozdělení nemají statický textový popisek.
ControlTypeProperty	Rozdělovací tlačítko	Tato hodnota je stejná pro všechny architektury uživatelského rozhraní.
LocalizedControlTypeProperty	rozdělené tlačítko	Lokalizovaný řetězec odpovídající typu ovládacího prvku SplitButton.
HelpTextProperty	Viz poznámky.	Text nápovědy může znamenat výsledek aktivace tlačítka rozdělení, což je obvykle stejný typ informací zobrazených prostřednictvím popisu.
IsContentElementProperty	Pravdivé	Ovládací prvek split button obsahuje informace pro koncového uživatele.
IsControlElementProperty	Pravdivé	Ovládací prvek rozděleného tlačítka je viditelný pro koncového uživatele.

Požadované vzory ovládacích prvků automatizace uživatelského rozhraní

V následující tabulce jsou uvedeny vzory ovládacích prvků automatizace uživatelského rozhraní, které je potřeba podporovat pomocí ovládacích prvků rozdělených tlačítek. Další informace o vzorech ovládacích prvků naleznete v tématu Přehled vzorů ovládacích prvků automatizace uživatelského rozhraní.

Vzor ovládacího prvku	Podpora	Poznámky
IInvokeProvider	Povinné	Tlačítka rozdělení mají vždy přidruženou výchozí akci pro vyvolání.
IExpandCollapseProvider	Povinné	Tlačítka rozdělení mají vždy možnost rozbalit seznam možností.

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

Následující tabulka uvádí události automatizace uživatelského rozhraní, které musí podporovat všechny ovládací prvky rozděleného tlačítka. 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
InvokedEvent	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é
ExpandCollapseStateProperty událost změny vlastnosti.	Povinné	Žádné
AutomationFocusChangedEvent	Povinné	Žádné
StructureChangedEvent	Povinné	Žádné

Příklad ovládacího prvku SplitButton

Následující obrázek znázorňuje typ ovládacího prvku SplitButton v ovládacím prvku datové mřížky.

Zobrazení ovládacích prvků a zobrazení obsahu stromu automatizace uživatelského rozhraní, které se vztahuje k mřížce dat a ovládacím prvkům tlačítka rozdělení, se zobrazí níže. Vzory ovládacích prvků pro každý prvek automatizace jsou zobrazeny v závorkách.

Strom automatizace uživatelského rozhraní – zobrazení ovládacího prvku	Strom automatizace uživatelského rozhraní – zobrazení obsahu
SplitButton Name (Invoke, ExpandCollapse) Tlačítko Další možnosti (vyvolání) Jídelní lístek Položka menu …	SplitButton Name (Invoke, ExpandCollapse) Tlačítko Další možnosti (vyvolání) Jídelní lístek Položka menu …

Viz také

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