Dela via

Flikkontrolltyp

  • Artikel

Det här avsnittet innehåller information om Microsoft UI Automation-stöd för -fliken kontrolltyp.

En flikkontroll motsvarar avdelarna i en notebook-fil eller etiketterna i ett filskåp. Genom att använda en flikkontroll kan ett program definiera flera sidor för samma område i ett fönster eller en dialogruta.

I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för Tab kontrolltyp. Kraven för UI Automation gäller för alla flikkontroller där UI-ramverket/plattformen integrerar UI Automation-stöd för kontrolltyper och kontrollmönster.

Det här avsnittet innehåller följande avsnitt.

Typisk trädstruktur

I följande tabell visas en typisk kontroll- och innehållsvy över UI Automation-trädet som avser flikkontroller och beskriver vad som kan finnas i varje vy. Mer information om UI Automation-trädet finns i UI Automation Tree Overview.

Kontrollvy Innehållsvy
  • Flik
    • TabItem (1 eller mer)
    • Rullningslist (0 eller 1)
      • Knapp (0 eller 2)
  • Flik
    • TabItem (1 eller mer)

 

Tabbkontroller har underordnade UI Automation-element baserat på TabItem kontrolltyp. När flikobjekt grupperas (till exempel som i Microsoft Office-program) kan -fliken kontrolltyp också vara värd för grupper kontrolltyper för de grupperade flikobjekten, som följande trädstruktur visar.

Kontrollvy Innehållsvy
  • Flik
    • TabItem (1 eller mer)
    • Grupp (0 eller mer)
      • TabItem (0 eller mer)
    • Rullningslist (0 eller 1)
      • Knapp (0 eller 2)
  • Flik
    • TabItem (1 eller mer)
    • Grupp (0 eller mer)
      • TabItem (0 eller mer)

 

Relevanta egenskaper

I följande tabell visas de UI Automation-egenskaper vars värde eller definition är särskilt relevant för tab-kontroller. Mer information om egenskaper för UI Automation finns i Hämta egenskaper från UI Automation-element.

UI Automation-egenskap Värde Anteckningar
UIA_AutomationIdPropertyId Se anteckningar. Värdet för den här egenskapen måste vara unikt bland alla peer-element i den råa vyn för UI Automation-trädet.
UIA_BoundingRectanglePropertyId Se anteckningar. Den yttersta rektangeln som innehåller hela kontrollen.
UIA_ClickablePointPropertyId Nej Tabbkontrollen har inte klickbara punkter.
UIA_ControlTypePropertyId fliken
UIA_IsContentElementPropertyId SANN Tabbkontrollen ingår alltid i innehållsvyn i UI Automation-trädet.
UIA_IsControlElementPropertyId SANN Tabbkontrollen ingår alltid i kontrollvyn för UI Automation-trädet.
UIA_IsKeyboardFocusablePropertyId SANN Kontrolltypen Tabb måste kunna ta emot tangentbordsfokus. Vanligtvis anropar en UI Automation-klient IUIAutomationElement::SetFocus på en flikkontroll och ett av dess objekt vidarebefordrar tangentbordsfokus till flikkontrollen. Det är möjligt att vissa flikcontainrar fokuserar utan att fokusera på något av dess objekt.
UIA_LabeledByPropertyId Se anteckningar. Tabbkontroller har vanligtvis en statisk textetikett som exponeras via den här egenskapen.
UIA_LocalizedControlTypePropertyId Se anteckningar. Lokaliserad sträng som motsvarar -fliken kontrolltyp. Standardvärdet är "tab" för en-US eller engelska (USA).
UIA_NamePropertyId Se anteckningar. Tabbkontrollen kräver sällan egenskapen Name.
UIA_OrientationPropertyId Se anteckningar. Tabbkontrollen måste alltid ange om den är placerad vågrätt eller lodrätt.

 

Nödvändiga kontrollmönster

I följande tabell visas de UI Automation-kontrollmönster som krävs för att stödjas av alla flikkontroller. Mer information om kontrollmönster finns i UI Automation Control Patterns Overview.

Kontrollmönster/mönsteregenskap Support/värde Anteckningar
ISelectionProvider Krävs Alla flikkontroller måste ha stöd för kontrollmönstret markering.
IsSelectionRequired SANN Tabbkontroller kräver alltid att ett val görs.
CanSelectMultiple FALSK Tabbkontroller är alltid containrar med enkel markering.
IScrollProvider Beror Kontrollmönstret Bläddra måste stödjas om flikkontrollen har widgetar som gör att en uppsättning flikobjekt kan bläddras igenom.

 

Nödvändiga händelser

I följande tabell visas de UI Automation-händelser som flikkontroller krävs för att stödja. Mer information om händelser finns i UI Automation Events Overview.

UI Automation-händelse Anteckningar
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId händelse som ändrats av egenskapen.
UIA_IsEnabledPropertyId händelse som ändrats av egenskapen. Om kontrollen stöder egenskapen IsEnabled måste den stödja den här händelsen.
UIA_IsOffscreenPropertyId händelse som ändrats av egenskapen. Om kontrollen stöder egenskapen IsOffscreen måste den ha stöd för den här händelsen.
UIA_ScrollHorizontallyScrollablePropertyId händelse som ändrats av egenskapen. Om kontrollen stöder kontrollmönstret Bläddra måste den ha stöd för den här händelsen.
UIA_ScrollHorizontalScrollPercentPropertyId händelse som ändrats av egenskapen. Om kontrollen stöder kontrollmönstret Bläddra måste den ha stöd för den här händelsen.
UIA_ScrollHorizontalViewSizePropertyId händelse som ändrats av egenskapen. Om kontrollen stöder kontrollmönstret Bläddra måste den ha stöd för den här händelsen.
UIA_ScrollVerticallyScrollablePropertyId händelse som ändrats av egenskapen. Om kontrollen stöder kontrollmönstret Bläddra måste den ha stöd för den här händelsen.
UIA_ScrollVerticalScrollPercentPropertyId händelse som ändrats av egenskapen. Om kontrollen stöder kontrollmönstret Bläddra måste den ha stöd för den här händelsen.
UIA_ScrollVerticalViewSizePropertyId händelse som ändrats av egenskapen. Om kontrollen stöder kontrollmönstret Bläddra måste den ha stöd för den här händelsen.
UIA_StructureChangedEventId

 

konceptuell

översikt över UI Automation-kontrolltyper

översikt över UI Automation