TcxCustomEditButton.Automation Property

Provides access to the editor button UI Automation and accessibility-related settings.

Declaration

property Automation: TdxAutomationElementSettings read; write;

Property Value

Type	Description
TdxAutomationElementSettings	Stores UI Automation tree node settings.

Remarks

Each editor button within the editor client area maps to a node in the UI Automation tree. A UIA client application reads properties of the UIA node that corresponds to the focused editor button.

Keyboard Navigation Between Editor Buttons

TcxCustomButtonEdit descendants do not implement dedicated keystrokes for navigation between multiple embedded buttons. Users need to rely on third-party assistive UIA tools to focus embedded buttons using a keyboard.

To focus an embedded editor button, you need to use the Move to next item command (or a similar counterpart) in a third-party assistive tool (UIA client) while the parent editor has focus.

For example, you need to press Caps Lock + → or Insert + →^[1] while Microsoft Narrator is active.

Available Options

An editor button uses Caption and Hint property values as corresponding node name and description in the UI Automation tree. You can use Automation.Name and Automation.Description properties to specify different name and description for the UIA node associated with the editor button.

Refer to the TdxAutomationElementSettings class description for detailed information on all available options.

Footnotes

1. Refer to the following topic for detailed information on keyboard configuration for Microsoft Narrator: Narrator Keyboard Commands and Touch Gestures.