Skip to content

Commit b39cba9

Browse files
icom85icom85
authored
Merge pull request #716 from telerik/Q2_2025
Q2 2025
2 parents 546ff1d + 5429355 commit b39cba9

File tree

32 files changed

+400
-164
lines changed

32 files changed

+400
-164
lines changed

‎controls/dropdown-listcontrol-and-checkeddropdownlist/dropdownlist/ui-automation.md‎

Lines changed: 18 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -55,11 +55,27 @@ The following section outlines the supported automation patterns for the __RadDr
5555

5656
## Editor or TextElement
5757

58-
The __DropDownStyle__ property of the control determines if direct text input is allowed inside the editor or not. When the style is set to DropDown we allow input which is handled by a hosted Microsoft TextBox control. In this case, the default TextBox implementation is responsible for handling UI Automation.
58+
The __DropDownStyle__ property of the control determines if direct text input is allowed inside the editor or not.
5959

6060
### Editor
6161

62-
The current implementation of UI Automation for the hosted Microsoft TextBox control is implemented as the UIA [Edit control type](https://learn.microsoft.com/en-us/windows/win32/winauto/uiauto-supporteditcontroltype)
62+
The current implementation of UI Automation for the RadDropDownList RadTextBoxItem control inside the editable area of the control is implemented as the UIA [Edit control type](https://learn.microsoft.com/en-us/windows/win32/winauto/uiauto-supporteditcontroltype)
63+
64+
#### Editor Available Properties
65+
66+
* AutomationElementIdentifiers.AutomationIdProperty.Id
67+
* AutomationElementIdentifiers.BoundingRectangleProperty.Id
68+
* AutomationElementIdentifiers.ClickablePointProperty.Id
69+
* AutomationElementIdentifiers.IsKeyboardFocusableProperty.Id
70+
* AutomationElementIdentifiers.NameProperty.Id
71+
* AutomationElementIdentifiers.ControlTypeProperty.Id
72+
* AutomationElementIdentifiers.LocalizedControlTypeProperty.Id => "edit"
73+
* AutomationElementIdentifiers.HelpTextProperty.Id
74+
* AutomationElementIdentifiers.IsContentElementProperty.Id
75+
* AutomationElementIdentifiers.IsControlElementProperty.Id
76+
* AutomationElementIdentifiers.IsPasswordProperty.Id
77+
* AutomationElementIdentifiers.IsTextPatternAvailableProperty.Id
78+
* AutomationElementIdentifiers.IsValuePatternAvailableProperty.Id
6379

6480
### TextElement
6581

‎controls/editors/maskededitbox/images/maskedEditBox-ui-automation001.png‎

149 KB
Loading

‎controls/editors/maskededitbox/ui-automation.md‎

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
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+
![maskedEditBox-ui-automation](images/maskedEditBox-ui-automation001.png)
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+
* [Value Pattern](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+

‎controls/editors/spineditor/ui-automation.md‎

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
---
2+
title: UI Automation Support (UI Accessibility)
3+
page_title: UI Automation Support (UI Accessibility) - RadSpinEditor
4+
description: UI Automation Support (UI Accessibility) for RadSpinEditor.
5+
slug: winforms/editors/spineditor-ui-automation
6+
tags: spineditor,ui,automation
7+
published: True
8+
position: 10
9+
---
10+
11+
# UI Automation Support
12+
13+
With the __Q2 2025__ version of our controls, RadSpinEditor supports UI Automation. The current implementation of UI Automation for RadSpinEditor 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.radSpinEditor1.EnableUIAutomation = false;
21+
22+
````
23+
````VB.NET
24+
25+
Me.RadSpinEditor1.EnableUIAutomation = False
26+
27+
````
28+
29+
<!--
30+
![maskedEditBox-ui-automation](images/maskedEditBox-ui-automation001.png)
31+
-->
32+
33+
## Relevant Properties
34+
35+
The table below outlines the __UI Automation__ properties most important for understanding and interacting with RadButton control.
36+
37+
* AutomationElementIdentifiers.AutomationIdProperty.Id
38+
* AutomationElementIdentifiers.BoundingRectangleProperty.Id
39+
* AutomationElementIdentifiers.ControlTypeProperty.Id
40+
* AutomationElementIdentifiers.LocalizedControlTypeProperty.Id => "spinner"
41+
* AutomationElementIdentifiers.HelpTextProperty.Id
42+
* AutomationElementIdentifiers.IsContentElementProperty.Id
43+
* AutomationElementIdentifiers.IsControlElementProperty.Id
44+
* AutomationElementIdentifiers.IsKeyboardFocusableProperty.Id
45+
* AutomationElementIdentifiers.LabeledByProperty.Id
46+
* AutomationElementIdentifiers.NameProperty.Id
47+
* AutomationElementIdentifiers.IsRangeValuePatternAvailableProperty.Id
48+
* AutomationElementIdentifiers.IsValuePatternAvailableProperty.Id
49+
50+
## Supported Control Patterns
51+
52+
The following section outlines the supported automation patterns for the __RadSpinEditor__ control and its constituent elements.
53+
54+
* [Value Pattern](https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.valuepattern?view=windowsdesktop-9.0)
55+
* [Range Value Pattern](https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.rangevaluepattern?view=windowsdesktop-9.0)
56+
57+
## Events
58+
59+
This section list the events raised by the RadSpinEditor control.
60+
61+
* __RadSpinElement.MinValue property change__: Raises the [UIA RangeValuePatternIdentifiers.MinimumProperty](https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.rangevaluepattern.minimumproperty?view=windowsdesktop-9.0) automation property change.
62+
63+
* __RadSpinElement.MaxValue property change__: Raises the [UIA RangeValuePatternIdentifiers.MaximumProperty](https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.rangevaluepattern.maximumproperty?view=windowsdesktop-9.0) automation property change.
64+
65+
* __ValueChanged event: Raises the
66+
67+
* [UIA ValuePatternIdentifiers.ValueProperty](https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.valuepattern.valueproperty?view=windowsdesktop-9.0) automation property changed.
68+
* UIA RangeValuePatternIdentifiers.ValueProperty](https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.rangevaluepattern.valueproperty?view=windowsdesktop-9.0)
69+
70+
71+
72+

‎controls/editors/textbox/images/textbox-ui-automation001.png‎

149 KB
Loading

‎controls/editors/textbox/ui-automation.md‎

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
---
2+
title: UI Automation Support (UI Accessibility)
3+
page_title: UI Automation Support (UI Accessibility) - RadTextBox
4+
description: UI Automation Support (UI Accessibility) for RadTextBox.
5+
slug: textbox-ui-automation
6+
tags: textbox,ui,automation
7+
published: True
8+
position: 10
9+
---
10+
11+
# UI Automation Support
12+
13+
With the __Q2 2025__ version of our controls, RadTextBox supports UI Automation. The current implementation of UI Automation for RadTextBox 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.radTextBox1.EnableUIAutomation = false;
21+
22+
````
23+
````VB.NET
24+
25+
Me.RadTextBox1.EnableUIAutomation = False
26+
27+
````
28+
29+
![textbox-ui-automation](images/textbox-ui-automation001.png)
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 __RadTextBox__ 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+
* [Value Pattern](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 RadTextBox 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+

‎controls/map/features/copyright_label.md‎

Lines changed: 98 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,98 @@
1+
---
2+
title: Copyright Label
3+
page_title: Copyright Label - RadMap
4+
description: Learn how to show Copyright Label in RadMap control.
5+
slug: winforms/map/features/copyright
6+
tags: copyright, label, map, features
7+
published: True
8+
position: 6
9+
---
10+
11+
# Copyright Label
12+
13+
The __RadMap__ control displays a copyright label at the bottom of the control.
14+
15+
This label is represented by the __MapCopyrightLabelElement__. You can access it via the __CopyrightLabelElement__ property and set its __Text__ property to customize the displayed content.
16+
17+
>caption Figure 1: Copyright Label
18+
19+
![WinForms RadMap Copyright Label](images/map-features-copyright-label.png)
20+
21+
## Set Copyright Label
22+
23+
````C#
24+
25+
this.radMap1.MapElement.CopyrightLabelElement.Text = "<html>© <a href=https://www.openstreetmap.org/copyright>OpenStreetMap</a> contributors";
26+
27+
````
28+
````VB.NET
29+
30+
Me.RadMap1.MapElement.CopyrightLabelElement.Text = "<html>© <a href=https://www.openstreetmap.org/copyright>OpenStreetMap</a> contributors"
31+
32+
````
33+
34+
## Customization
35+
36+
The MapCopyrightLabelElement can be further customized to suit your specific requirements.
37+
38+
### Aligment
39+
40+
The element's Alignment property determines its position. While the ContentAlignment enumeration includes vertical options such as Top, Middle, and Bottom, these are not applicable here—the copyright label is always positioned at the bottom of the map. By default, the alignment is set to MiddleRight, as shown in the first image of the article.
41+
42+
> Note that selecting TopRight or BottomRight produces the same visual result due to the fixed bottom placement of the label.
43+
44+
All three center alignments __ContentAlignment.MiddleCenter__, __ContentAlignment.TopCenter__, __ContentAlignment.BottomCenter__ result in the screenshot below:
45+
46+
````C#
47+
48+
this.radMap1.MapElement.CopyrightLabelElement.Alignment = ContentAlignment.MiddleCenter;
49+
50+
````
51+
````VB.NET
52+
53+
Me.RadMap1.MapElement.CopyrightLabelElement.Alignment = ContentAlignment.MiddleCenter
54+
55+
````
56+
57+
![WinForms RadMap Copyright Label Aligment Center](images/map-features-copyright-label-aligment-center.png)
58+
59+
All three left alignments __ContentAlignment.MiddleLeft__, __ContentAlignment.TopLeft__, __ContentAlignment.BottomLeft__ result in the screenshot below:
60+
61+
````C#
62+
63+
this.radMap1.MapElement.CopyrightLabelElement.Alignment = ContentAlignment.MiddleLeft;
64+
65+
````
66+
````VB.NET
67+
68+
Me.RadMap1.MapElement.CopyrightLabelElement.Alignment = ContentAlignment.MiddleLeft
69+
70+
````
71+
72+
![WinForms RadMap Copyright Label Aligment Left](images/map-features-copyright-label-aligment-left.png)
73+
74+
75+
### Margin
76+
77+
The Margin property of the copyright label element is especially useful for fine-tuning its position relative to surrounding elements. For example, you can adjust the margin values to "stick" the label closer to the bottom edge of the map, if such a design is desired.
78+
79+
````C#
80+
81+
this.radMap1.MapElement.Margin = new Padding(0, 8, 20, 0);
82+
83+
````
84+
````VB.NET
85+
86+
Me.RadMap1.MapElement.Margin = new Padding(0, 8, 20, 0)
87+
88+
````
89+
90+
![WinForms RadMap Copyright Label Margin](images/map-features-copyright-label-aligment-margin.png)
91+
92+
## See Also
93+
94+
* [Layers Overview]({%slug winforms/map/features/layers/overview%})
95+
* [Mini Map]({%slug winforms/map/features/minimap%})
96+
* [Navigation Controls]({%slug winforms/map/features/navigation-controls%})
97+
* [Scale Indicators]({%slug winforms/map/features/scale-indicators%})
98+
* [Legend]({%slug winforms/map/features/legend%})

‎controls/map/features/images/map-features-copyright-label-aligment-center.png‎

121 KB
Loading

‎controls/map/features/images/map-features-copyright-label-aligment-left.png‎

134 KB
Loading

‎controls/map/features/images/map-features-copyright-label-aligment-margin.png‎

166 KB
Loading

0 commit comments

Comments
 (0)