Stöd för användargränssnittsautomatisering för kontrolltypen RadioButton
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 kontrolltypen RadioButton. 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 alternativknapp består av en rund knapp och programdefinierad text (en etikett), en ikon eller en bitmapp som anger ett val som användaren kan göra genom att välja knappen. Ett program använder vanligtvis alternativknappar i en gruppruta för att tillåta användaren att välja mellan en uppsättning relaterade, men ömsesidigt uteslutande alternativ. Programmet kan till exempel visa en grupp med alternativknappar från vilka användaren kan välja en formatinställning för text som valts i klientområdet. Användaren kan välja ett vänsterjusterat, högerjusterat eller centrerat format genom att välja motsvarande alternativknapp. Normalt kan användaren bara välja ett alternativ i taget från en uppsättning alternativknappar.
I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för kontrolltypen RadioButton. 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 i UI Automation-trädet som gäller för alternativknappskontroller 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 |
|---|---|
| Radiobutton | Radiobutton |
Det finns inga underordnade objekt i kontrollvyn eller innehållsvyn.
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 kontrolltypen RadioButton. 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. | Alternativknappkontrollens namn är den text som visas bredvid knappen som behåller markeringstillståndet. |
| ClickablePointProperty | Se anteckningar. | Alternativknappkontrollens klickbara punkt MÅSTE vara en punkt som anger markeringen på alternativknappen om den klickas med en muspekare. |
| LabeledByProperty | Null |
Alternativknappar är självetiketteringskontroller. |
| ControlTypeProperty | Radiobutton | Det här värdet är detsamma för alla gränssnittsramverk. |
| LocalizedControlTypeProperty | "alternativknapp" | Lokaliserad sträng som motsvarar kontrolltypen RadioButton. |
| IsContentElementProperty | Sant | Alternativknappkontrollen ingår alltid i innehållsvyn i UI Automation-trädet. |
| IsControlElementProperty | Sant | Alternativknappskontrollen ingår alltid i kontrollvyn för UI Automation-trädet. |
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 alternativknappskontroller. Mer information om kontrollmönster finns i Översikt över UI Automation-kontrollmönster.
| Egenskapen Kontrollmönster/kontrollmönster | Support/värde | Kommentar |
|---|---|---|
| ISelectionItemProvider | Ja | Alla alternativknappskontroller måste ha stöd för mönstret Markeringsobjekt så att de kan väljas. |
| SelectionContainer | Se anteckningar. | SelectionContainerProperty Måste alltid slutföras så att en UI Automation-klient kan avgöra vilka andra alternativknappar i en specifik kontext som är relaterade till varandra. För Win32-versionen av alternativknappen stöds inte den här egenskapen eftersom det inte går att hämta den här informationen från det äldre ramverket. |
| IToggleProvider | Aldrig | Radioknappen kan inte växla genom dess tillstånd när den har ställts in. Det här mönstret får aldrig stödjas på alternativknappen. |
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 alternativknappskontroller. Mer information om händelser finns i Översikt över UI Automation-händelser.
| UI Automation-händelse | Support | Kommentar |
|---|---|---|
| ElementRemovedFromSelectionEvent | Obligatoriskt | Ingen |
| ElementSelectedEvent | Obligatoriskt | Ingen |
| ToggleStateProperty händelse som ändrats av egenskapen. | Aldrig | 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 |
| AutomationFocusChangedEvent | Obligatoriskt | Ingen |
| StructureChangedEvent | Obligatoriskt | Inga |