Stöd för användargränssnittsautomatisering för flikkontrolltypen
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 UI Automation-stöd för flikkontrolltypen. 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 innehåller specifika riktlinjer för UI Automation-trädstruktur, UI Automation-egenskapsvärden och UI Automation. kontrollmönster.
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 kontrolltypen Tabb. Kraven för UI Automation gäller för alla flikkontroller, oavsett om Windows Presentation Foundation (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 flikkontroller 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 |
|---|---|
Flik
|
Flik – TabItem (1 eller mer) |
Flikkontroller har underordnade UI Automation-element baserat på kontrolltypen Tabbobjekt. När flikobjekt grupperas (till exempel som i Microsoft Office 2007-program) kan kontrolltypen Tabb också vara värd för gruppers kontrolltyper för grupperade flikobjekt, som följande trädstruktur visar.
| Kontrollvy | Innehållsvy |
|---|---|
Flik
|
Flik
|
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 kontrolltypen Tabb. 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. |
| IsKeyboardFocusableProperty | Se anteckningar. | Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen. |
| NameProperty | Se anteckningar. | Tabbkontrollen kräver sällan en namnegenskap. |
| ClickablePointProperty | Nej | Tabbkontrollen har ingen klickbar punkt. |
| LabeledByProperty | Se anteckningar. | Tabbkontroller har vanligtvis en statisk textetikett som exponeras via den här egenskapen. |
| ControlTypeProperty | Flik | Det här värdet är detsamma för alla gränssnittsramverk. |
| LocalizedControlTypeProperty | "tab" | Lokaliserad sträng som motsvarar kontrolltypen Tabb. |
| IsKeyboardFocusableProperty | Sant | Kontrolltypen Tabb måste kunna ta emot tangentbordsfokus. Vanligtvis anropar en UI Automation-klient SetFocus på en flikkontroll och ett av objekten vidarebefordrar tangentbordsfokus till flikkontrollen. Det är möjligt att vissa flikcontainrar fokuserar utan att fokusera på något av dess objekt. |
| IsContentElementProperty | Sant | Tabbkontrollen ingår alltid i innehållsvyn i UI Automation-trädet. |
| IsControlElementProperty | Sant | Tabbkontrollen ingår alltid i kontrollvyn för UI Automation-trädet. |
| OrientationProperty | Se anteckningar. | Tabbkontrollen måste alltid ange om den är placerad vågrätt eller lodrätt. |
Obligatoriska UI Automation-kontrollmönster och egenskaper
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 Översikt över UI Automation-kontrollmönster.
| Kontrollmönster/mönsteregenskap | Support/värde | Kommentar |
|---|---|---|
| ISelectionProvider | Ja | Alla flikkontroller måste ha stöd för markeringsmönstret. |
| IsSelectionRequired | Sant | Tabbkontroller kräver alltid att ett val görs. |
| CanSelectMultiple | Falsk | Tabbkontroller är alltid containrar med enkel markering. |
| IScrollProvider | Beror | Rullningsmönstret måste stödjas i flikkontrollen med widgetar som gör att en uppsättning flikobjekt kan bläddras igenom. |
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 flikkontroller. Mer information om händelser finns i Översikt över UI Automation-händelser.
| UI Automation-händelse | Support | Kommentar |
|---|---|---|
| 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 |
| HorizontallyScrollableProperty 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 |
| VerticalViewSizeProperty händelse som ändrats av egenskapen. | Beror | Ingen |
| AutomationFocusChangedEvent | Obligatoriskt | Ingen |
| StructureChangedEvent | Obligatoriskt | Inga |