Skip to main content
All docs
V26.1
  • TdxAutomationElementSettings.IsControlElement Property

    Specifies if the control/UI element belongs to the control view of the UI Automation tree.

    Declaration

    property IsControlElement: TdxDefaultBoolean read; write; default bDefault;

    Property Value

    Type Default Description
    TdxDefaultBoolean bDefault
    bDefault
    The default value interpretation depends on the control/UI element type.
    bTrue
    The control/UI element is explicitly included in the control view of the UI Automation tree.
    bFalse
    The control/UI element is explicitly excluded from the control view of the UI Automation tree.

    Remarks

    Control and Content Views are subsets of an entire UI Automation tree (Raw View) designed to limit UI element visibility to third-party assistive tools depending on usage scenarios.

    Control View

    The control view includes all interactive UI elements (buttons, editor boxes, and other elements that can accept input focus) and visual elements that form the logical structure of the UI (headers, toolbars, menus, etc.). The control view does not include decorative non-interactive UI elements.

    The UI control type (terminal class) defines whether a DevExpress UI control/UI element is initially included in the control view. You can set the IsControlElement property to bTrue or bFalse to explicitly include/exclude the control/UI element to/from the control view of the UI Automation tree.

    Content View

    The content view is a subset of the control view. The content view is designed to include only the UI elements that display meaningful information in a user interface, including UI elements that can receive focus. For example, the content view lists all drop-down menu item values because users can select them.

    The UI control type (terminal class) defines whether a DevExpress UI control/UI element is initially included in the content view. You can set the IsContentElement property to bTrue or bFalse to explicitly include/exclude the control/UI element to/from the content view of the UI Automation tree.

    Corresponding UIA Framework Field

    The IsControlElement property corresponds to the AutomationElementIdentifiers.IsControlElementProperty field.

    Default Value

    The IsControlElement property’s default value is bDefault.

    See Also