Stöd för användargränssnittsautomatisering för kontrolltypen CheckBox
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 Microsoft UI Automation-stöd för kontrolltypen CheckBox. 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.
En kryssruta är ett objekt som används för att ange ett tillstånd som användarna kan interagera med för att gå igenom det tillståndet. Kryssrutorna visar antingen ett binärt alternativ (ja/nej), (på/av) eller tertiärt (på, av, obestämd) för användaren.
I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för kontrolltypen CheckBox. Kraven för UI Automation gäller för alla kryssrutekontroller, 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 för kryssrutekontroller 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 |
|---|---|
| CheckBox | CheckBox |
Kommentar
Kryssrutorna har aldrig underordnade element i kontroll- eller innehållsvyn. Om kontrollen behöver innehålla underordnade element anger detta att en annan kontrolltyp ska användas.
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 kryssrutekontroller. 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. | Stöds om det finns en rektangel för avgränsning. Om inte varje punkt i avgränsningsrektangeln är klickbar och du utför specialiserad träfftestning åsidosätter du och anger en klickbar punkt. |
| ControlTypeProperty | CheckBox | Det här värdet är detsamma för alla gränssnittsramverk. |
| IsContentElementProperty | Sant | Värdet för den här egenskapen måste alltid vara Sant. Det innebär att kryssrutan alltid måste ingå i innehållsvyn i UI Automation-trädet. |
| IsControlElementProperty | Sant | Värdet för den här egenskapen måste alltid vara Sant. Det innebär att kryssrutan alltid måste ingå 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 | Null |
Kryssrutor är självetiketteringskontroller. |
| LocalizedControlTypeProperty | "kryssruta" | Lokaliserad sträng som motsvarar kontrolltypen Kryssruta. |
| NameProperty | Se anteckningar. | Värdet för kryssrutans egenskap Name är den text som visas bredvid rutan som behåller växlingsläget. |
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 alla kryssrutekontroller. Mer information om kontrollmönster finns i Översikt över UI Automation-kontrollmönster.
| Kontrollmönster | Support | Kommentar |
|---|---|---|
| IToggleProvider | Obligatoriskt | Gör att kryssrutan kan växlas genom dess interna tillstånd programmatiskt. |
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 kryssrutekontroller. Mer information om händelser finns i Översikt över UI Automation-händelser.
| UI Automation-händelse | Support | Kommentar |
|---|---|---|
| AutomationFocusChangedEvent | Obligatoriskt | 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 |
| StructureChangedEvent | Obligatoriskt | Ingen |
| ToggleStateProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
Standardåtgärd
Standardåtgärden i kryssrutan är att göra så att en alternativknapp blir fokuserad och växlar dess aktuella tillstånd. Som tidigare nämnts visar kryssrutor antingen ett binärt beslut (Ja/Nej) (på/av) för användaren eller en tertiär (på, av, obestämd). Om kryssrutan är binär gör standardåtgärden att tillståndet "på" blir "av" eller att tillståndet "av" blir "på". I ett tertiärt tillstånd kryssrutan standardåtgärden växlar genom tillstånd i kryssrutan i samma ordning som om användaren hade skickat efterföljande musklickningar till kontrollen.