Kontrolltyp för radioknapp
Det här avsnittet innehåller information om Microsoft UI Automation-stöd för kontrolltypen RadioButton.
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.
Not
En annan kontrollgeneralisering för knappar där endast en i en grupp kan väljas är innehållet i en växlingsknapp. Vissa gränssnittsramverk anser att en alternativknapp är en specialiserad växlingsknapp.
I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för RadioButton kontrolltyp. Kraven för användargränssnittsautomatisering gäller för alla knappkontroller där UI-ramverket/plattformen integrerar UI Automation-stöd för kontrolltyper och kontrollmönster.
Det här avsnittet innehåller följande avsnitt.
- typisk trädstruktur
- relevanta egenskaper
- nödvändiga kontrollmönster
- nödvändiga händelser
- kommentarer
- Relaterade ämnen
Typisk trädstruktur
I följande tabell visas en typisk kontroll- och innehållsvy över 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 UI Automation Tree Overview.
Kontrollvy | Innehållsvy |
---|---|
|
|
Det finns inga underordnade objekt i kontrollvyn eller innehållsvyn.
Relevanta egenskaper
I följande tabell visas UI Automation-egenskaper vars värde eller definition är särskilt relevanta för de kontroller som implementerar RadioButton kontrolltyp (till exempel knappkontroller). Mer information om egenskaper för UI Automation finns i Hämta egenskaper från UI Automation-element.
UI Automation-egenskap | Värde | Anteckningar |
---|---|---|
UIA_AutomationIdPropertyId | Se anteckningar. | Värdet för den här egenskapen måste vara unikt bland alla peer-element i den råa vyn för UI Automation-trädet. |
UIA_BoundingRectanglePropertyId | Se anteckningar. | Den yttersta rektangeln som innehåller hela kontrollen. |
UIA_ClickablePointPropertyId | Se anteckningar. | Den klickbara punkten måste vara en punkt som när du klickar väljer alternativknappen. |
UIA_ControlTypePropertyId | RadioButton | |
UIA_IsContentElementPropertyId | SANN | Alternativknappkontrollen ingår alltid i innehållsvyn i UI Automation-trädet. |
UIA_IsControlElementPropertyId | SANN | Alternativknappskontrollen ingår alltid i kontrollvyn för UI Automation-trädet. |
UIA_IsKeyboardFocusablePropertyId | Se anteckningar. | Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen. |
UIA_LabeledByPropertyId | NOLL | Kontrollerna för alternativknappar är självmärkta av innehållet. |
UIA_LocalizedControlTypePropertyId | Se anteckningar. | Lokaliserad sträng som motsvarar RadioButton kontrolltyp. Standardvärdet är "alternativknapp" för en-US eller engelska (USA). |
UIA_NamePropertyId | Se anteckningar. | Namnet på alternativknappskontrollen är den text som visas bredvid knappen som behåller markeringstillståndet. |
Nödvändiga 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/mönsteregenskap | Support/värde | Anteckningar |
---|---|---|
ISelectionItemProvider | Krävs | Alla alternativknappskontroller måste ha stöd för SelectionItem kontrollmönster så att de kan väljas själva. |
SelectionContainer | Se anteckningar. | Egenskapen SelectionContainer 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 Microsoft 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. Kontrollmönstret Växla får aldrig stödjas på en alternativknapp. |
Nödvändiga händelser
I följande tabell visas de UI Automation-händelser som knappkontroller krävs för att stödja. Mer information om händelser finns i UI Automation Events Overview.
UI Automation-händelse | Anteckningar |
---|---|
UIA_AutomationFocusChangedEventId | |
UIA_BoundingRectanglePropertyId händelse som ändrats av egenskapen. | |
UIA_IsEnabledPropertyId händelse som ändrats av egenskapen. | Om kontrollen stöder egenskapen IsEnabled måste den stödja den här händelsen. |
UIA_IsOffscreenPropertyId händelse som ändrats av egenskapen. | Om kontrollen stöder egenskapen IsOffscreen måste den ha stöd för den här händelsen. |
UIA_SelectionItem_ElementRemovedFromSelectionEventId | Om kontrollen stöder SelectionItem kontrollmönster måste den stödja den här händelsen. |
UIA_SelectionItem_ElementSelectedEventId | Om kontrollen stöder SelectionItem kontrollmönster måste den stödja den här händelsen. |
UIA_StructureChangedEventId |
Anmärkningar
En alternativknapp representerar ett enda valbart alternativ bland en grupp peer-alternativknappar. Helst bör alternativknappar ha ett grupperingselement som klargör gränserna för peer-alternativknapparna. Ofta är dock gränsen underförstådd av UI-elementstrukturen. En meny kan till exempel innehålla en uppsättning på varandra följande alternativknappar i stället för menyalternativ, eller en uppsättning alternativknappar som inträffar efter en gruppetikett, men före ett åtgärdsbart element, till exempel knapp.
Relaterade ämnen
-
konceptuell
-
översikt över UI Automation-kontrolltyper
-
översikt över UI Automation