UI Automation Support

With the Q4 2024 version of our controls, RadListControl supports UI Automation. The current implementation of UI Automation for RadListControl is similar to the MS WinForms List 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.radListControl1.EnableUIAutomation = false;

Me.RadListControl1.EnableUIAutomation = False

RadListControl

The table below outlines the UI Automation properties most important for understanding and interacting with RadListControl control.

RadListControl Available Properties

• AutomationElementIdentifiers.AutomationIdProperty.Id
• AutomationElementIdentifiers.BoundingRectangleProperty.Id
• AutomationElementIdentifiers.ControlTypeProperty => ControlType.List.Id
• AutomationElementIdentifiers.LocalizedControlTypeProperty => "list"
• AutomationElementIdentifiers.HelpTextProperty.Id
• AutomationElementIdentifiers.IsContentElementProperty.Id
• AutomationElementIdentifiers.IsControlElementProperty.Id
• AutomationElementIdentifiers.IsKeyboardFocusableProperty.Id
• AutomationElementIdentifiers.HasKeyboardFocusProperty.Id
• AutomationElementIdentifiers.NameProperty.Id

RadListControl Available Patterns

The following section outlines the supported automation patterns for the RadListControl control and its constituent elements.

• Selection Control Pattern
• Scroll Control Pattern

RadListDataItem

The current implementation of UI Automation for the RadListDataItem control is implemented as the UIA ListItem control type

RadListDataItem Available Properties

• AutomationElementIdentifiers.AutomationIdProperty.Id
• AutomationElementIdentifiers.BoundingRectangleProperty.Id
• AutomationElementIdentifiers.ControlTypeProperty => ControlType.List.Id
• AutomationElementIdentifiers.LocalizedControlTypeProperty => "list"
• AutomationElementIdentifiers.HelpTextProperty.Id
• AutomationElementIdentifiers.IsContentElementProperty.Id
• AutomationElementIdentifiers.IsControlElementProperty.Id
• AutomationElementIdentifiers.IsKeyboardFocusableProperty.Id
• AutomationElementIdentifiers.HasKeyboardFocusProperty.Id
• AutomationElementIdentifiers.NameProperty.Id
• AutomationElementIdentifiers.IsOffscreenProperty.Id

RadListDataItem Available Patterns

• Selection Control Pattern
• ScrollItem Control Pattern

RadScrollbarElement

The current implementation of UI Automation for the RadScrollbarElement control is implemented as the UIA ScrollBar control type

RadScrollbarElement Available Properties

• AutomationElementIdentifiers.AutomationIdProperty.Id
• AutomationElementIdentifiers.BoundingRectangleProperty.Id
• AutomationElementIdentifiers.ControlTypeProperty => ControlType.ScrollBar.Id
• AutomationElementIdentifiers.LocalizedControlTypeProperty => "scroll bar"
• AutomationElementIdentifiers.HelpTextProperty.Id
• AutomationElementIdentifiers.IsContentElementProperty.Id
• AutomationElementIdentifiers.IsControlElementProperty.Id
• AutomationElementIdentifiers.IsKeyboardFocusableProperty.Id
• AutomationElementIdentifiers.NameProperty.Id
• AutomationElementIdentifiers.OrientationProperty.Id

RadScrollbarElement Available Patterns

• RangeValue Control Pattern

ScrollBarButton

The current implementation of UI Automation for the ScrollBarButton control is implemented as the UIA Button control type

ScrollBarButton Available Properties

• AutomationElementIdentifiers.AutomationIdProperty.Id
• AutomationElementIdentifiers.BoundingRectangleProperty.Id
• AutomationElementIdentifiers.ControlTypeProperty => ControlType.Button.Id
• AutomationElementIdentifiers.LocalizedControlTypeProperty => "button"
• AutomationElementIdentifiers.HelpTextProperty.Id
• AutomationElementIdentifiers.IsContentElementProperty.Id
• AutomationElementIdentifiers.IsControlElementProperty.Id
• AutomationElementIdentifiers.IsKeyboardFocusableProperty.Id
• AutomationElementIdentifiers.NameProperty.Id

ScrollBarButton Available Patterns

• Invoke Control Pattern

ScrollBarThumb

The current implementation of UI Automation for the ScrollBarThumb control is implemented as the UIA ScrollBar control type

ScrollBarThumb Available Properties

• AutomationElementIdentifiers.AutomationIdProperty.Id
• AutomationElementIdentifiers.BoundingRectangleProperty.Id
• AutomationElementIdentifiers.ControlTypeProperty => ControlType.Thumb.Id
• AutomationElementIdentifiers.LocalizedControlTypeProperty => "thumb"
• AutomationElementIdentifiers.HelpTextProperty.Id
• AutomationElementIdentifiers.IsContentElementProperty.Id
• AutomationElementIdentifiers.IsControlElementProperty.Id
• AutomationElementIdentifiers.IsKeyboardFocusableProperty.Id
• AutomationElementIdentifiers.NameProperty.Id

ScrollBarThumb Available Patterns

• Transform Control Pattern