Stöd för UI Automation för trädkontrolltypen
Kommentar
Den här dokumentationen System.Windows.Automation är avsedd för .NET Framework-utvecklare som vill använda de hanterade UI Automation-klasserna som definierats i namnområdet. Den senaste informationen om UI Automation finns i Windows Automation API: UI Automation.
Det här avsnittet innehåller information om stöd för UI Automation för trädkontrolltypen. I UI Automation är en kontrolltyp en uppsättning villkor som en kontroll måste uppfylla för att kunna använda egenskapen ControlTypeProperty . Villkoren omfattar specifika riktlinjer för UI Automation-trädstruktur, UI Automation-egenskapsvärden och kontrollmönster.
Kontrolltypen Träd 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 Microsoft Windows Explorer. 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.
I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för trädkontrolltypen. UI Automation-kraven gäller för alla trädkontroller, oavsett om windows presentationsstiftelsen (WPF), Win32 eller Windows Forms.
Obligatorisk trädstruktur för användargränssnittsautomatisering
I följande tabell visas kontrollvyn och innehållsvyn för UI Automation-trädet som gäller trädkontroller och beskriver vad som kan finnas i varje vy. Mer information om UI Automation-trädet finns i Översikt över UI Automation Tree.
| Kontrollvy | Innehållsvy |
|---|---|
Träd
|
Träd
|
Kontrollvyn för UI Automation-trädet består av:
Noll till många objekt i containern (objekt kan baseras på trädobjekt, dataobjekt eller annan kontrolltyp).
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å trädobjekt, dataobjekt eller annan kontrolltyp).
Nödvändiga egenskaper för UI Automation
I följande tabell visas de UI Automation-egenskaper vars värde eller definition är särskilt relevant för listkontroller. Mer information om egenskaper för UI Automation finns i UI Automation Properties for Clients (Egenskaper för gränssnittsautomatisering för klienter).
| UI Automation-egenskap | Värde | Kommentar |
|---|---|---|
| AutomationIdProperty | Se anteckningar. | Värdet för den här egenskapen måste vara unikt för alla kontroller i ett program. |
| BoundingRectangleProperty | Se anteckningar. | Den yttersta rektangeln som innehåller hela kontrollen. |
| ClickablePointProperty | Se anteckningar. | Trädkontroller har en klickbar punkt som gör att trädet eller ett objekt i trädcontainern har fokus inställt på dem. Du får bara en klickbar punkt för ett träd om du kan klicka någonstans som inte gör att något av objekten väljs/får fokus. |
| ControlTypeProperty | Träd | Det här värdet är detsamma för alla gränssnittsramverk. |
| IsContentElementProperty | Sant | Trädkontrollen ingår alltid i innehållsvyn i UI Automation-trädet. |
| IsControlElementProperty | Sant | Trädkontrollen ingår alltid i kontrollvyn för UI Automation-trädet. |
| IsKeyboardFocusableProperty | Se anteckningar. | Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen. |
| LabeledByProperty | Se anteckningar. | Om trädkontrollen har en etikett associerad med den returnerar den här egenskapen en AutomationElement för den etiketten. Annars returnerar egenskapen en null-referens (Nothing i Microsoft Visual Basic .NET). |
| LocalizedControlTypeProperty | "träd" | Lokaliserad sträng som motsvarar kontrolltypen Lista. |
| NameProperty | 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 programutvecklaren ange ett värde för den här egenskapen. |
Nödvändiga UI Automation-kontrollmönster
I följande tabell visas de UI Automation-kontrollmönster som krävs för att stödjas av listkontroller. Mer information om kontrollmönster finns i Översikt över UI Automation-kontrollmönster.
| Kontrollmönster/mönsteregenskap | Support/värde | Kommentar |
|---|---|---|
| ISelectionProvider | Beror | Trädkontroller som innehåller en uppsättning valbara objekt måste implementera det här kontrollmönstret. Det här kontrollmönstret behöver inte implementeras om valet av ett objekt inte förmedlar 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. |
| IScrollProvider | Beror | Implementera det här kontrollmönstret om innehållet i trädcontainern kan rullas. |
Nödvändiga UI Automation-händelser
I följande tabell visas de UI Automation-händelser som krävs för att stödjas av alla trädkontroller. Mer information om händelser finns i Översikt över UI Automation-händelser.
| UI Automation-händelse | Support | Kommentar |
|---|---|---|
| InvalidatedEvent | Beror | Ingen |
| BoundingRectangleProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| IsOffscreenProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| IsEnabledProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| HorizontallyScrollableProperty händelse som ändrats av egenskapen. | Beror | Ingen |
| HorizontalScrollPercentProperty händelse som ändrats av egenskapen. | Beror | Ingen |
| HorizontalViewSizeProperty händelse som ändrats av egenskapen. | Beror | Ingen |
| VerticalScrollPercentProperty händelse som ändrats av egenskapen. | Beror | Ingen |
| VerticallyScrollableProperty händelse som ändrats av egenskapen. | Beror | Ingen |
| VerticalViewSizeProperty händelse som ändrats av egenskapen. | Beror | Ingen |
| AutomationFocusChangedEvent | Obligatoriskt | Ingen |
| StructureChangedEvent | Obligatoriskt | Inga |