UI Automation Support

With the Q1 2025 version of our controls, RadLabel supports UI Automation. The current implementation of UI Automation for RadLabel is similar to the MS WinForms Text 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.radLabel1.EnableUIAutomation = false;

Me.RadLabel1.EnableUIAutomation = False

Relevant Properties

The table below outlines the UI Automation properties most important for understanding and interacting with RadLabel 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 => "text"
• AutomationElementIdentifiers.HelpTextProperty.Id
• AutomationElementIdentifiers.IsContentElementProperty.Id
• AutomationElementIdentifiers.IsControlElementProperty.Id
• AutomationElementIdentifiers.IsKeyboardFocusableProperty.Id
• AutomationElementIdentifiers.NameProperty.Id

Supported Control Patterns

The RadLabelUIAutomationProvider class does not expose any supported patterns.

The RadLabel control raises the following events

• OnTextChanged: Raises the:

  • UIA TextPatternIdentifiers.TextChangedEvent Field
  • UIA AutomationElementIdentifiers.NameProperty Field

• OnEnabledChanged: Raises the UIA AutomationElementIdentifiers.IsEnabledProperty Field