Stöd för användargränssnittsautomatisering för rullningslistkontrolltypen
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 användargränssnittsautomatisering för kontrolltypen Rullningslist. 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 kontrollmönster.
Rullningslistkontroller gör det möjligt för en användare att rulla innehåll i ett fönster eller en objektcontainer. Kontrollen består av en uppsättning knappar och en tumkontroll.
I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för kontrolltypen Rullningslist. Kraven för användargränssnittsautomatisering gäller för alla listkontroller, oavsett om det gäller 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 för rullningslistkontroller 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 |
|---|---|
| Rullningslisten - Knapp (2 eller 4) - Tumme (0 eller 1) |
Ej tillämpbart. Rullningslistkontrollen innehåller inte innehåll. |
Rullningslistkontrollen har alltid tre till fem underordnade objekt. Eftersom underträdet har mer än en knappkontroll måste du ange ett specifikt AutomationIdProperty värde för varje objekt för att göra dem identifierbara för testautomatiseringsverktyg.
Nödvändiga egenskaper för UI Automation
I följande tabell visas UI Automation-egenskaper vars värde eller definition är särskilt relevant för rullningslistkontroller. Observera att en rullningslistkontroll aldrig har innehåll. dess funktioner exponeras via rullningskontrollmönstret, som stöds på containern som rullas.
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 | Null |
Kontrollen för rullningslisten har inga innehållselement och NameProperty behöver inte anges. |
| ClickablePointProperty | Inte ett tal. | Rullningslistkontrollen har inte klickbara punkter. |
| LabeledByProperty | Null |
Rullningslister har inga etiketter. |
| ControlTypeProperty | Rullningslisten | Det här värdet är detsamma för alla ramverk. Rullningslister som fungerar som skjutreglage måste använda skjutreglagets kontrolltyp. |
| LocalizedControlTypeProperty | "rullningslist" | Lokaliserad sträng som motsvarar knappkontrolltypen. |
| IsContentElementProperty | Falsk | Rullningslistkontrollen är aldrig ett innehållselement. Om rullningslisten är en fristående kontroll måste den uppfylla skjutreglagets kontrolltyp och returnera ControlType.Slider för ControlType egenskapen. |
| IsControlElementProperty | Sant | Rullningslisten måste alltid vara en kontroll. |
| OrientationProperty | Sant | Rullningslistkontrollen måste alltid exponera dess vågräta eller lodräta orientering. |
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 rullningslistkontroller. Mer information om kontrollmönster finns i Översikt över UI Automation-kontrollmönster. Observera att när en rullningslist endast används som en kontroll för musmanipulering stöder den inte kontrollmönster. Om den används som skjutreglage i ett program måste den ges skjutreglagets kontrolltyp.
| Kontrollmönster | Support | Kommentar |
|---|---|---|
| IScrollProvider | Aldrig | Mönstret för rullningskontroll stöds aldrig direkt i rullningslisten. |
| IRangeValueProvider | Beror | Den här funktionen måste endast stödjas om mönstret för rullningskontroll inte stöds i containern som har rullningslisten. |
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 rullningslistkontroller. Mer information om händelser finns i Översikt över UI Automation-händelser.
| UI Automation-händelse | Support/värde | 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. | Aldrig | Ingen |
| HorizontalScrollPercentProperty händelse som ändrats av egenskapen. | Aldrig | Ingen |
| HorizontalViewSizeProperty händelse som ändrats av egenskapen. | Aldrig | Ingen |
| VerticalScrollPercentProperty händelse som ändrats av egenskapen. | Aldrig | Ingen |
| VerticallyScrollableProperty händelse som ändrats av egenskapen. | Aldrig | Ingen |
| VerticalViewSizeProperty händelse som ändrats av egenskapen. | Aldrig | Ingen |
| ValueProperty händelse som ändrats av egenskapen. | Beror | Ingen |
| AutomationFocusChangedEvent | Obligatoriskt | Ingen |
| StructureChangedEvent | Obligatoriskt | Inga |