Sdílet prostřednictvím


Typ ovládacího prvku SplitButton

Toto téma obsahuje informace o podpoře automatizace uživatelského rozhraní Společnosti Microsoft pro typ ovládacího prvku SplitButton.

Ovládací prvek rozděleného tlačítka umožňuje provádět akci u ovládacího prvku a rozbalit ovládací prvek, aby se zobrazil seznam dalších možných akcí, které je možné 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 SplitBut ton. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky rozděleného tlačítka, kde architektura uživatelského rozhraní nebo platforma integrují 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ů 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
  • SplitButton
    • Obrázek (0 nebo 1)
    • Text (0 nebo 1)
    • Tlačítko (1 nebo 2)
      • Nabídka (0 nebo 1; zobrazí se jako podřízený podklíč, který podporuje vzor ExpandCollapse).
        • MenuItem (1 až mnoho)
  • SplitButton
    • Tlačítko (1 nebo 2)
      • MenuItem (1 až mnoho)

 

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 SplitBut ton. 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 SplitButton Tato hodnota je stejná pro všechny architektury uživatelského rozhraní.
UIA_HelpTextPropertyId 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.
UIA_IsContentElementPropertyId PRAVDIVÝ Ovládací prvek split button obsahuje informace pro koncového uživatele.
UIA_IsControlElementPropertyId PRAVDIVÝ Ovládací prvek rozděleného tlačítka je viditelný pro koncového uživatele.
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čítka Rozdělení nemají statický textový popisek.
UIA_LocalizedControlTypePropertyId Viz poznámky. Lokalizovaný řetězec odpovídající typu ovládacího prvku SplitButton. Výchozí hodnota je "split button" pro en-US nebo angličtinu (Spojené státy).
UIA_NamePropertyId Viz poznámky. Text, který slouží k označení tlačítka rozdělení Při každém použití obrázku k označení rozděleného tlačítka musí být pro vlastnost Název rozděleného 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í podporovat všechny ovládací prvky rozděleného tlačítka. 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ý Vzhledem k tomu, že rozdělená tlačítka mají vždy možnost rozbalit seznam možností, musí podporovat ExpandCollapse vzor ovládacího prvku.
IInvokeProvider Požadovaný Vzhledem k tomu, že tlačítka rozdělení mají vždy výchozí akci přidruženou k metodě IInvokeProvider::Invoke, musí podporovat Invoke vzor ovládacího prvku.

 

Požadované události

V následující tabulce jsou uvedeny události automatizace uživatelského rozhraní, které jsou potřeba k podpoře ovládacích prvků tlačítka rozdělení. 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_ExpandCollapseExpandCollapseStatePropertyId událost změněnou vlastností.
UIA_Invoke_InvokedEventId
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

 

Příklad typu ovládacího prvku SplitButton

Následující obrázek znázorňuje ovládací prvek, který implementuje typ ovládacího prvku SplitButton.

snímek obrazovky znázorňující příklad ovládacího prvku splitbutton

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žnost (vyvolání)
      • Menu
        • MenuItem
        • ...
  • SplitButton Name (Invoke, ExpandCollapse)
    • Tlačítko Další možnost (vyvolání)
      • Menu
        • MenuItem
        • ...

 

koncepční

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

Přehled automatizace uživatelského rozhraní