diff --git a/controls/dropdown-listcontrol-and-checkeddropdownlist/dropdownlist/ui-automation.md b/controls/dropdown-listcontrol-and-checkeddropdownlist/dropdownlist/ui-automation.md index 5d9bda295..187ceb7bf 100644 --- a/controls/dropdown-listcontrol-and-checkeddropdownlist/dropdownlist/ui-automation.md +++ b/controls/dropdown-listcontrol-and-checkeddropdownlist/dropdownlist/ui-automation.md @@ -55,11 +55,27 @@ The following section outlines the supported automation patterns for the __RadDr ## Editor or TextElement -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. +The __DropDownStyle__ property of the control determines if direct text input is allowed inside the editor or not. ### Editor -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) +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) + +#### Editor Available Properties + +* AutomationElementIdentifiers.AutomationIdProperty.Id +* AutomationElementIdentifiers.BoundingRectangleProperty.Id +* AutomationElementIdentifiers.ClickablePointProperty.Id +* AutomationElementIdentifiers.IsKeyboardFocusableProperty.Id +* AutomationElementIdentifiers.NameProperty.Id +* AutomationElementIdentifiers.ControlTypeProperty.Id +* AutomationElementIdentifiers.LocalizedControlTypeProperty.Id => "edit" +* AutomationElementIdentifiers.HelpTextProperty.Id +* AutomationElementIdentifiers.IsContentElementProperty.Id +* AutomationElementIdentifiers.IsControlElementProperty.Id +* AutomationElementIdentifiers.IsPasswordProperty.Id +* AutomationElementIdentifiers.IsTextPatternAvailableProperty.Id +* AutomationElementIdentifiers.IsValuePatternAvailableProperty.Id ### TextElement diff --git a/controls/editors/maskededitbox/images/maskedEditBox-ui-automation001.png b/controls/editors/maskededitbox/images/maskedEditBox-ui-automation001.png new file mode 100644 index 000000000..1b24ef96f Binary files /dev/null and b/controls/editors/maskededitbox/images/maskedEditBox-ui-automation001.png differ diff --git a/controls/editors/maskededitbox/ui-automation.md b/controls/editors/maskededitbox/ui-automation.md new file mode 100644 index 000000000..7322cac26 --- /dev/null +++ b/controls/editors/maskededitbox/ui-automation.md @@ -0,0 +1,70 @@ +--- +title: UI Automation Support (UI Accessibility) +page_title: UI Automation Support (UI Accessibility) - RadMaskedEditBox +description: UI Automation Support (UI Accessibility) for RadMaskedEditBox. +slug: maskededitbox-ui-automation +tags: maskededitbox,ui,automation +published: True +position: 10 +--- + +# UI Automation Support + +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. + +This functionality is enabled by default. To disable it, you can set the __EnableUIAutomation__ property to false. + + +````C# + +this.radMaskedEditBox1.EnableUIAutomation = false; + +```` +````VB.NET + +Me.RadMaskedEditBox1.EnableUIAutomation = False + +```` + +![maskedEditBox-ui-automation](images/maskedEditBox-ui-automation001.png) + +## Relevant Properties + +The table below outlines the __UI Automation__ properties most important for understanding and interacting with RadButton control. + +* AutomationElementIdentifiers.AutomationIdProperty.Id +* AutomationElementIdentifiers.BoundingRectangleProperty.Id +* AutomationElementIdentifiers.ClickablePointProperty.Id +* AutomationElementIdentifiers.IsKeyboardFocusableProperty.Id +* AutomationElementIdentifiers.NameProperty.Id +* AutomationElementIdentifiers.ControlTypeProperty.Id +* AutomationElementIdentifiers.LocalizedControlTypeProperty.Id => "edit" +* AutomationElementIdentifiers.HelpTextProperty.Id +* AutomationElementIdentifiers.IsContentElementProperty.Id +* AutomationElementIdentifiers.IsControlElementProperty.Id +* AutomationElementIdentifiers.IsPasswordProperty.Id +* AutomationElementIdentifiers.IsTextPatternAvailableProperty.Id +* AutomationElementIdentifiers.IsValuePatternAvailableProperty.Id + +## Supported Control Patterns + +The following section outlines the supported automation patterns for the __RadMaskedEditBox__ control and its constituent elements. + +* [Text Pattern](https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.textpattern?view=windowsdesktop-9.0) +* [Value Pattern](https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.valuepattern?view=windowsdesktop-9.0) + +## Events + +This section list the events raised by the RadMaskedEditBox control. + +* __Selection in the control change__: Raises the : + [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) + +* __OnTextChanged__: Raises the: + * [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) + * [UIA AutomationElementIdentifiers.NameProperty Field](https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.valuepattern.valueproperty?view=windowsdesktop-9.0) + +* __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) + + + diff --git a/controls/editors/spineditor/ui-automation.md b/controls/editors/spineditor/ui-automation.md new file mode 100644 index 000000000..23818f031 --- /dev/null +++ b/controls/editors/spineditor/ui-automation.md @@ -0,0 +1,72 @@ +--- +title: UI Automation Support (UI Accessibility) +page_title: UI Automation Support (UI Accessibility) - RadSpinEditor +description: UI Automation Support (UI Accessibility) for RadSpinEditor. +slug: winforms/editors/spineditor-ui-automation +tags: spineditor,ui,automation +published: True +position: 10 +--- + +# UI Automation Support + +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. + +This functionality is enabled by default. To disable it, you can set the __EnableUIAutomation__ property to false. + + +````C# + +this.radSpinEditor1.EnableUIAutomation = false; + +```` +````VB.NET + +Me.RadSpinEditor1.EnableUIAutomation = False + +```` + + + +## Relevant Properties + +The table below outlines the __UI Automation__ properties most important for understanding and interacting with RadButton control. + +* AutomationElementIdentifiers.AutomationIdProperty.Id +* AutomationElementIdentifiers.BoundingRectangleProperty.Id +* AutomationElementIdentifiers.ControlTypeProperty.Id +* AutomationElementIdentifiers.LocalizedControlTypeProperty.Id => "spinner" +* AutomationElementIdentifiers.HelpTextProperty.Id +* AutomationElementIdentifiers.IsContentElementProperty.Id +* AutomationElementIdentifiers.IsControlElementProperty.Id +* AutomationElementIdentifiers.IsKeyboardFocusableProperty.Id +* AutomationElementIdentifiers.LabeledByProperty.Id +* AutomationElementIdentifiers.NameProperty.Id +* AutomationElementIdentifiers.IsRangeValuePatternAvailableProperty.Id +* AutomationElementIdentifiers.IsValuePatternAvailableProperty.Id + +## Supported Control Patterns + +The following section outlines the supported automation patterns for the __RadSpinEditor__ control and its constituent elements. + +* [Value Pattern](https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.valuepattern?view=windowsdesktop-9.0) +* [Range Value Pattern](https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.rangevaluepattern?view=windowsdesktop-9.0) + +## Events + +This section list the events raised by the RadSpinEditor control. + +* __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. + +* __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. + +* __ValueChanged event: Raises the + + * [UIA ValuePatternIdentifiers.ValueProperty](https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.valuepattern.valueproperty?view=windowsdesktop-9.0) automation property changed. + * UIA RangeValuePatternIdentifiers.ValueProperty](https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.rangevaluepattern.valueproperty?view=windowsdesktop-9.0) + + + + diff --git a/controls/editors/textbox/images/textbox-ui-automation001.png b/controls/editors/textbox/images/textbox-ui-automation001.png new file mode 100644 index 000000000..1b24ef96f Binary files /dev/null and b/controls/editors/textbox/images/textbox-ui-automation001.png differ diff --git a/controls/editors/textbox/ui-automation.md b/controls/editors/textbox/ui-automation.md new file mode 100644 index 000000000..78f5e79e6 --- /dev/null +++ b/controls/editors/textbox/ui-automation.md @@ -0,0 +1,70 @@ +--- +title: UI Automation Support (UI Accessibility) +page_title: UI Automation Support (UI Accessibility) - RadTextBox +description: UI Automation Support (UI Accessibility) for RadTextBox. +slug: textbox-ui-automation +tags: textbox,ui,automation +published: True +position: 10 +--- + +# UI Automation Support + +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. + +This functionality is enabled by default. To disable it, you can set the __EnableUIAutomation__ property to false. + + +````C# + +this.radTextBox1.EnableUIAutomation = false; + +```` +````VB.NET + +Me.RadTextBox1.EnableUIAutomation = False + +```` + +![textbox-ui-automation](images/textbox-ui-automation001.png) + +## Relevant Properties + +The table below outlines the __UI Automation__ properties most important for understanding and interacting with RadButton control. + +* AutomationElementIdentifiers.AutomationIdProperty.Id +* AutomationElementIdentifiers.BoundingRectangleProperty.Id +* AutomationElementIdentifiers.ClickablePointProperty.Id +* AutomationElementIdentifiers.IsKeyboardFocusableProperty.Id +* AutomationElementIdentifiers.NameProperty.Id +* AutomationElementIdentifiers.ControlTypeProperty.Id +* AutomationElementIdentifiers.LocalizedControlTypeProperty.Id => "edit" +* AutomationElementIdentifiers.HelpTextProperty.Id +* AutomationElementIdentifiers.IsContentElementProperty.Id +* AutomationElementIdentifiers.IsControlElementProperty.Id +* AutomationElementIdentifiers.IsPasswordProperty.Id +* AutomationElementIdentifiers.IsTextPatternAvailableProperty.Id +* AutomationElementIdentifiers.IsValuePatternAvailableProperty.Id + +## Supported Control Patterns + +The following section outlines the supported automation patterns for the __RadTextBox__ control and its constituent elements. + +* [Text Pattern](https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.textpattern?view=windowsdesktop-9.0) +* [Value Pattern](https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.valuepattern?view=windowsdesktop-9.0) + +## Events + +This section list the events raised by the RadTextBox control. + +* __Selection in the control change__: Raises the : + [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) + +* __OnTextChanged__: Raises the: + * [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) + * [UIA AutomationElementIdentifiers.NameProperty Field](https://learn.microsoft.com/en-us/dotnet/api/system.windows.automation.valuepattern.valueproperty?view=windowsdesktop-9.0) + +* __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) + + + diff --git a/controls/map/features/copyright_label.md b/controls/map/features/copyright_label.md new file mode 100644 index 000000000..3bffd4ac0 --- /dev/null +++ b/controls/map/features/copyright_label.md @@ -0,0 +1,71 @@ +--- +title: Copyright Label +page_title: Copyright Label - RadMap +description: Learn how to show Copyright Label in RadMap control. +slug: winforms/map/features/copyright +tags: copyright, label, map, features +published: True +position: 6 +--- + +# Copyright Label + +The __RadMap__ control displays a copyright label at the bottom of the control. + +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. + +>caption Figure 1: Copyright Label + +![WinForms RadMap Copyright Label](images/map-features-copyright-label.png) + +## Set Copyright Label + +````C# + +this.radMap1.MapElement.CopyrightLabelElement.Text = "© OpenStreetMap contributors"; + +```` +````VB.NET + +Me.RadMap1.MapElement.CopyrightLabelElement.Text = "© OpenStreetMap contributors" + +```` + +## Customization + +The MapCopyrightLabelElement can be further customized to suit your specific requirements. + +### Aligment + +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. + +> Note that selecting TopRight or BottomRight produces the same visual result due to the fixed bottom placement of the label. + +All three center alignments __ContentAlignment.MiddleCenter__, __ContentAlignment.TopCenter__, __ContentAlignment.BottomCenter__ result in the screenshot below: + +````C# + +this.radMap1.MapElement.CopyrightLabelElement.Alignment = ContentAlignment.MiddleCenter; + +```` +````VB.NET + +Me.RadMap1.MapElement.CopyrightLabelElement.Alignment = ContentAlignment.MiddleCenter + +```` + +![WinForms RadMap Copyright Label Aligment Center](images/map-features-copyright-label-aligment-center.png) + +All three left alignments __ContentAlignment.MiddleLeft__, __ContentAlignment.TopLeft__, __ContentAlignment.BottomLeft__ result in the screenshot below: + +![WinForms RadMap Copyright Label Aligment Left](images/map-features-copyright-label-aligment-left.png) + + + +## See Also + +* [Layers Overview]({%slug winforms/map/features/layers/overview%}) +* [Mini Map]({%slug winforms/map/features/minimap%}) +* [Navigation Controls]({%slug winforms/map/features/navigation-controls%}) +* [Scale Indicators]({%slug winforms/map/features/scale-indicators%}) +* [Legend]({%slug winforms/map/features/legend%}) diff --git a/controls/map/features/images/map-features-copyright-label-aligment-center.png b/controls/map/features/images/map-features-copyright-label-aligment-center.png new file mode 100644 index 000000000..3f5de1a8a Binary files /dev/null and b/controls/map/features/images/map-features-copyright-label-aligment-center.png differ diff --git a/controls/map/features/images/map-features-copyright-label-aligment-left.png b/controls/map/features/images/map-features-copyright-label-aligment-left.png new file mode 100644 index 000000000..848830178 Binary files /dev/null and b/controls/map/features/images/map-features-copyright-label-aligment-left.png differ diff --git a/controls/map/features/images/map-features-copyright-label-aligment-margin.png b/controls/map/features/images/map-features-copyright-label-aligment-margin.png new file mode 100644 index 000000000..591eceaf7 Binary files /dev/null and b/controls/map/features/images/map-features-copyright-label-aligment-margin.png differ diff --git a/controls/map/features/images/map-features-copyright-label.png b/controls/map/features/images/map-features-copyright-label.png new file mode 100644 index 000000000..6b758194a Binary files /dev/null and b/controls/map/features/images/map-features-copyright-label.png differ