Dela via

Stöd för användargränssnittsautomatisering för kontrolltypen RadioButton

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 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 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 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 Sann Alternativknappkontrollen ingår alltid i innehållsvyn i UI Automation-trädet.
IsControlElementProperty Sann 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 UI Automation Control Patterns Overview.

Kontrollmönster/kontrollmönsteregenskap Support/värde Noteringar
ISelectionItemProvider Ja Alla alternativknappskontroller måste ha stöd för markeringsobjektmönstret, 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 radio-knappar i en specifik kontext som relaterar 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 UI Automation Events Overview.

UI Automation-händelse Stöd Noteringar
ElementRemovedFromSelectionEvent Krävs Ingen
ElementSelectedEvent Krävs Ingen
ToggleStateProperty egenskapsändringshändelse. Aldrig Ingen
BoundingRectangleProperty egenskapsändringshändelse. Krävs Ingen
IsOffscreenProperty egenskapsändringshändelse. Krävs Ingen
IsEnabledProperty egenskapsändringshändelse. Krävs Ingen
AutomationFocusChangedEvent Krävs Ingen
StructureChangedEvent Krävs Ingen

Se även

  • Last updated on