Dela via

Trädkontrolltyp

  • Artikel

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

Kontrolltypen Tree används för containrar vars innehåll har relevans som en hierarki med noder, som med hur filer och mappar visas i den vänstra rutan i Utforskaren. Varje nod har potential att innehålla andra noder, så kallade underordnade noder. Överordnade noder, eller noder som innehåller underordnade noder, kan visas som expanderade eller komprimerade. Trädvisningskontrollen i Windows (som identifieras av WC_TREEVIEW) är ett exempel på en kontroll som tillhör kontrolltypen Tree.

I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för Tree-kontrolltypen. Kraven för användargränssnittsautomatisering gäller för alla trädobjektkontroller 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 gäller för trädkontroller 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
  • Träd
    • DataItem (0 eller mer)
    • TreeItem (0 eller mer)
      • TreeItem (0 eller mer)
        • ...
    • Rullningslist (0, 1, 2)
  • Träd
    • DataItem (0 eller mer)
    • TreeItem (0 eller mer)
      • TreeItem (0 eller mer)
        • ...

 

Kontrollvyn för UI Automation-trädet består av:

  • Noll av många objekt i containern (objekt kan baseras på TreeItem eller DataItem kontrolltyper).
  • Kontroller med noll, en eller två rullningslister

Innehållsvyn i UI Automation-trädet består av noll eller många objekt i containern (objekt kan baseras på TreeItem eller DataItem kontrolltyper).

Relevanta egenskaper

I följande tabell visas UI Automation-egenskaper vars värde eller definition är särskilt relevant för kontrolltypen Tree. 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 Se anteckningar. Trädkontroller har en klickbar punkt som gör att trädet eller något av objekten i trädcontainern får fokus. En trädkontroll kan bara ha en klickbar punkt om det är möjligt att klicka på en plats i trädet utan att orsaka att ett objekt markeras eller att ta emot fokus.
UIA_ControlTypePropertyId träd Det här värdet är detsamma för alla gränssnittsramverk.
UIA_IsContentElementPropertyId SANN Trädkontrollen ingår alltid i innehållsvyn i UI Automation-trädet.
UIA_IsControlElementPropertyId SANN Trädkontrollen ingår alltid i kontrollvyn för UI Automation-trädet.
UIA_IsKeyboardFocusablePropertyId Se anteckningar. Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen.
UIA_LabeledByPropertyId Se anteckningar. Om trädkontrollen har en etikett associerad med den returnerar den här egenskapen en IUIAutomationElement pekare för etiketten. Annars returnerar egenskapen en null-referens.
UIA_LocalizedControlTypePropertyId Se anteckningar. Lokaliserad sträng som motsvarar Träd kontrolltyp. Standardvärdet är "tree" för en-US eller engelska (USA).
UIA_NamePropertyId Se anteckningar. Värdet för en trädkontrolls namnegenskap kommer vanligtvis från text som etiketterar kontrollen. Om det inte finns någon textetikett måste du ange ett värde för den här egenskapen.

 

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 trädkontroller. Mer information om kontrollmönster finns i UI Automation Control Patterns Overview.

Kontrollmönster/mönsteregenskap Support/värde Anteckningar
IScrollProvider Beror Implementera kontrollmönstret Bläddra om objekt i trädcontainern kan rullas.
ISelectionProvider Beror Trädkontroller som innehåller en uppsättning valbara objekt måste implementera kontrollmönstret markering. Det behöver inte implementeras om valet av ett objekt inte förmedlar någon meningsfull information till användaren.
CanSelectMultiple Se anteckningar. Implementera den här egenskapen om trädkontrollen stöder flera val (de flesta trädkontroller stöder inte flera val).
IsSelectionRequired Se anteckningar. Värdet för den här egenskapen visas om kontrollen kräver att ett objekt väljs.

 

Nödvändiga händelser

I följande tabell visas de UI Automation-händelser som alla trädkontroller måste ha stöd för. 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_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_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_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_Selection_InvalidatedEventId Om kontrollen stöder kontrollmönstret Selection 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