Not
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Anmärkning
Den här dokumentationen är avsedd för .NET Framework-utvecklare som vill använda de hanterade UI Automation-klasserna som definierats i System.Windows.Automation namnrymd. 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 |
|---|---|
| Skrollbar - 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 | Noteringar |
|---|---|---|
| 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 | Skrollbar | Det här värdet är detsamma för alla ramverk. Rullningslister som fungerar som skjutreglage måste använda kontrolltypen skjutreglage. |
| LocalizedControlTypeProperty | skrollist | 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 kontrolltypen "Skjutreglage" och returnera ControlType.Slider för egenskapen ControlType. |
| IsControlElementProperty | Sann | Scrolllisten måste alltid vara en kontroll. |
| OrientationProperty | Sann | 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 UI Automation Control Patterns Overview. 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 tilldelas kontrolltypen Skjutreglage.
| Kontrollmönster | Stöd | Noteringar |
|---|---|---|
| IScrollProvider | Aldrig | Mönstret för rullningskontroll stöds aldrig direkt i rullningslisten. |
| IRangeValueProvider | Det beror på | 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 UI Automation Events Overview.
| UI Automation-händelse | Support/värde | Noteringar |
|---|---|---|
| BoundingRectangleProperty egenskapsändringshändelse. | Krävs | Ingen |
| IsOffscreenProperty egenskapsändringshändelse. | Krävs | Ingen |
| IsEnabledProperty egenskapsändringshändelse. | Krävs | Ingen |
| HorizontallyScrollableProperty egenskapsändringshändelse. | Aldrig | Ingen |
| HorizontalScrollPercentProperty egenskapsändringshändelse. | Aldrig | Ingen |
| HorizontalViewSizeProperty egenskapsändringshändelse. | Aldrig | Ingen |
| VerticalScrollPercentProperty egenskapsändringshändelse. | Aldrig | Ingen |
| VerticallyScrollableProperty egenskapsändringshändelse. | Aldrig | Ingen |
| VerticalViewSizeProperty egenskapsändringshändelse. | Aldrig | Ingen |
| ValueProperty egenskapsändringshändelse. | Det beror på | Ingen |
| AutomationFocusChangedEvent | Krävs | Ingen |
| StructureChangedEvent | Krävs | Ingen |
Se även
- ScrollBar
- översikt över typer av UI Automation-kontroller
- översikt över UI Automation