|
| 1 | +--- |
| 2 | +title: UI Automation Support (UI Accessibility) |
| 3 | +page_title: UI Automation Support (UI Accessibility) - RadMaskedEditBox |
| 4 | +description: UI Automation Support (UI Accessibility) for RadMaskedEditBox. |
| 5 | +slug: maskededitbox-ui-automation |
| 6 | +tags: maskededitbox,ui,automation |
| 7 | +published: True |
| 8 | +position: 10 |
| 9 | +--- |
| 10 | + |
| 11 | +# UI Automation Support |
| 12 | + |
| 13 | +With the __Q2 2025__ version of our controls, RadMaskedEditBox supports UI Automation. The current implementation of UI Automation for RadMaskedEditBox is similar to the MS WinForms Edit 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. |
| 14 | + |
| 15 | +This functionality is enabled by default. To disable it, you can set the __EnableUIAutomation__ property to false. |
| 16 | + |
| 17 | + |
| 18 | +````C# |
| 19 | + |
| 20 | +this.radMaskedEditBox1.EnableUIAutomation = false; |
| 21 | + |
| 22 | +```` |
| 23 | +````VB.NET |
| 24 | + |
| 25 | +Me.RadMaskedEditBox1.EnableUIAutomation = False |
| 26 | + |
| 27 | +```` |
| 28 | + |
| 29 | + |
| 30 | + |
| 31 | +## Relevant Properties |
| 32 | + |
| 33 | +The table below outlines the __UI Automation__ properties most important for understanding and interacting with RadButton control. |
| 34 | + |
| 35 | +* AutomationElementIdentifiers.AutomationIdProperty.Id |
| 36 | +* AutomationElementIdentifiers.BoundingRectangleProperty.Id |
| 37 | +* AutomationElementIdentifiers.ClickablePointProperty.Id |
| 38 | +* AutomationElementIdentifiers.IsKeyboardFocusableProperty.Id |
| 39 | +* AutomationElementIdentifiers.NameProperty.Id |
| 40 | +* AutomationElementIdentifiers.ControlTypeProperty.Id |
| 41 | +* AutomationElementIdentifiers.LocalizedControlTypeProperty.Id => "edit" |
| 42 | +* AutomationElementIdentifiers.HelpTextProperty.Id |
| 43 | +* AutomationElementIdentifiers.IsContentElementProperty.Id |
| 44 | +* AutomationElementIdentifiers.IsControlElementProperty.Id |
| 45 | +* AutomationElementIdentifiers.IsPasswordProperty.Id |
| 46 | +* AutomationElementIdentifiers.IsTextPatternAvailableProperty.Id |
| 47 | +* AutomationElementIdentifiers.IsValuePatternAvailableProperty.Id |
| 48 | + |
| 49 | +## Supported Control Patterns |
| 50 | + |
| 51 | +The following section outlines the supported automation patterns for the __RadMaskedEditBox__ control and its constituent elements. |
| 52 | + |
| 53 | +* [Text Pattern](https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.textpattern?view=windowsdesktop-9.0) |
| 54 | +* [ValuePattern](https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.valuepattern?view=windowsdesktop-9.0) |
| 55 | + |
| 56 | +## Events |
| 57 | + |
| 58 | +This section list the events raised by the RadMaskedEditBox control. |
| 59 | + |
| 60 | +* __Selection in the control change__: Raises the : |
| 61 | + [UIA TextPatternIdentifiers.TextSelectionChangedEvent](https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.textpattern.textselectionchangedevent?view=windowsdesktop-9.0#system-windows-automation-textpattern-textselectionchangedevent) |
| 62 | + |
| 63 | +* __OnTextChanged__: Raises the: |
| 64 | + * [UIA TextPatternIdentifiers.TextChangedEvent Field](https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.textpatternidentifiers.textchangedevent?view=windowsdesktop-9.0#system-windows-automation-textpatternidentifiers-textchangedevent) |
| 65 | + * [UIA AutomationElementIdentifiers.NameProperty Field](https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.valuepattern.valueproperty?view=windowsdesktop-9.0) |
| 66 | + |
| 67 | +* __OnEnabledChanged__: Raises the [UIA AutomationElementIdentifiers.IsEnabledProperty Field](https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.automationelementidentifiers.isenabledproperty?view=windowsdesktop-9.0#system-windows-automation-automationelementidentifiers-isenabledproperty) |
| 68 | + |
| 69 | + |
| 70 | + |
0 commit comments