Sdílet prostřednictvím

Typ ovládacího prvku Tab

  • Článek

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

Ovládací prvek tabulátoru je podobný rozdělovačům v poznámkovém bloku nebo popiskům v souborové skříni. Pomocí ovládacího prvku karta může aplikace definovat více stránek pro stejnou oblast okna nebo dialogového okna.

Následující části definují požadovanou stromovou strukturu, vlastnosti, vzory ovládacích prvků a události pro typ ovládacího prvku Tab. Požadavky na automatizaci uživatelského rozhraní platí pro všechny ovládací prvky karet, 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ů karet 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
  • Tabulátor
    • TabItem (1 nebo více)
    • Posuvník (0 nebo 1)
      • Tlačítko (0 nebo 2)
  • Tabulátor
    • TabItem (1 nebo více)

 

Ovládací prvky tab mají podřízené prvky automatizace uživatelského rozhraní založené na typu ovládacího prvku TabItem. Když jsou položky karet seskupené (například v aplikacích Microsoft Office), typ ovládacího prvku Tab může také hostovat typy ovládacích prvků Skupiny typy ovládacích prvků pro položky seskupených karet, jak ukazuje následující stromová struktura.

Zobrazení ovládacího prvku Zobrazení obsahu
  • Tabulátor
    • TabItem (1 nebo více)
    • Skupina (0 nebo více)
      • TabItem (0 nebo více)
    • Posuvník (0 nebo 1)
      • Tlačítko (0 nebo 2)
  • Tabulátor
    • TabItem (1 nebo více)
    • Skupina (0 nebo více)
      • TabItem (0 nebo více)

 

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 karet. 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 Ne Ovládací prvek tab neobsahuje klikatelné body.
UIA_ControlTypePropertyId tabulátoru
UIA_IsContentElementPropertyId PRAVDIVÝ Ovládací prvek karta je vždy součástí zobrazení obsahu stromu Automatizace uživatelského rozhraní.
UIA_IsControlElementPropertyId PRAVDIVÝ Ovládací prvek karta je vždy součástí zobrazení ovládacího prvku stromu Automatizace uživatelského rozhraní.
UIA_IsKeyboardFocusablePropertyId PRAVDIVÝ Typ ovládacího prvku Tab musí být schopen přijímat fokus klávesnice. Klient automatizace uživatelského rozhraní obvykle volá IUIAutomationElement::SetFocus na ovládacím prvku karty a jedna z jejích položek přesměruje fokus klávesnice na ovládací prvek karta. Některé kontejnery karet se můžou soustředit bez nastavení fokusu na jednu z jejích položek.
UIA_LabeledByPropertyId Viz poznámky. Ovládací prvky tabulátoru mají obvykle statický textový popisek, který je vystaven prostřednictvím této vlastnosti.
UIA_LocalizedControlTypePropertyId Viz poznámky. Lokalizovaný řetězec odpovídající typu ovládacího prvku Tab. Výchozí hodnota je "tab" pro en-US nebo angličtinu (Spojené státy).
UIA_NamePropertyId Viz poznámky. Ovládací prvek karta zřídka vyžaduje vlastnost Název.
UIA_OrientationPropertyId Viz poznámky. Ovládací prvek tabulátoru musí vždy určovat, jestli je umístěn vodorovně nebo svisle.

 

Požadované vzory ovládacích prvků

V následující tabulce jsou uvedeny vzory ovládacích prvků automatizace uživatelského rozhraní, které musí být podporovány všemi ovládacími prvky karet. 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
ISelectionProvider Požadovaný Všechny ovládací prvky karet musí podporovat výběr vzor ovládacího prvku.
IsSelectionRequired PRAVDIVÝ Ovládací prvky tabulátoru vždy vyžadují provedení výběru.
CanSelectMultiple FALEŠNÝ Ovládací prvky tabulátoru jsou vždy kontejnery s jedním výběrem.
IScrollProvider Závisí Ovládací vzor ovládacích prvků scroll musí být podporován, pokud ovládací prvek tab obsahuje widgety, které umožňují posouvání sady položek karet.

 

Požadované události

V následující tabulce jsou uvedeny události automatizace uživatelského rozhraní, které ovládací prvky karet 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_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_ScrollHorizontallyScrollablePropertyId událost změněnou vlastností. Pokud ovládací prvek podporuje vzor ovládacích prvků Scroll, musí tuto událost podporovat.
UIA_ScrollHorizontalScrollPercentPropertyId událost změněnou vlastností. Pokud ovládací prvek podporuje vzor ovládacích prvků Scroll, musí tuto událost podporovat.
UIA_ScrollHorizontalViewSizePropertyId událost změněnou vlastností. Pokud ovládací prvek podporuje vzor ovládacích prvků Scroll, musí tuto událost podporovat.
UIA_ScrollVerticallyScrollablePropertyId událost změněnou vlastností. Pokud ovládací prvek podporuje vzor ovládacích prvků Scroll, musí tuto událost podporovat.
UIA_ScrollVerticalScrollPercentPropertyId událost změněnou vlastností. Pokud ovládací prvek podporuje vzor ovládacích prvků Scroll, musí tuto událost podporovat.
UIA_ScrollVerticalViewSizePropertyId událost změněnou vlastností. Pokud ovládací prvek podporuje vzor ovládacích prvků Scroll, musí tuto událost podporovat.
UIA_StructureChangedEventId

 

koncepční

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

Přehled automatizace uživatelského rozhraní