UI Automation Support
With the Q1 2025 version of our controls, RadToggleButton supports UI Automation. The current implementation of UI Automation for RadToggleButton is similar to the MS WinForms CheckBox Control Type implementation with some extended functionality. The main goal of this implementation is to ensure compliance with accessibility standards and to provide a common practice for automated testing.
This functionality is enabled by default. To disable it, you can set the EnableUIAutomation property to false.
this.radToggleButton1.EnableUIAutomation = false;
Me.RadToggleButton1.EnableUIAutomation = False
Relevant Properties
The table below outlines the UI Automation properties most important for understanding and interacting with RadToggleButton control.
RadRepeatButton
- AutomationElementIdentifiers.AutomationIdProperty.Id
- AutomationElementIdentifiers.AcceleratorKeyProperty.Id
- AutomationElementIdentifiers.AccessKeyProperty.Id
- AutomationElementIdentifiers.BoundingRectangleProperty.Id
- AutomationElementIdentifiers.ControlTypeProperty.Id
- AutomationElementIdentifiers.LabeledByProperty.Id
- AutomationElementIdentifiers.IsEnabledProperty.Id
- AutomationElementIdentifiers.LocalizedControlTypeProperty.Id => "check box"
- AutomationElementIdentifiers.HelpTextProperty.Id
- AutomationElementIdentifiers.IsContentElementProperty.Id
- AutomationElementIdentifiers.IsControlElementProperty.Id
- AutomationElementIdentifiers.IsKeyboardFocusableProperty.Id
- AutomationElementIdentifiers.NameProperty.Id
Supported Control Patterns
The following section outlines the supported automation patterns for the RadToggleButton control and its constituent elements.
The RadToggleButton control raises the following events
OnClick: Raises the UIA InvokePatternIdentifiers.InvokedEvent Field
OnGotFocus: Raises the UIA AutomationElementIdentifiers.AutomationFocusChangedEvent Field
OnEnabledChanged: Raises the UIA AutomationElementIdentifiers.IsEnabledProperty Field