Developer Express XtraGrid Support

Applies to TestComplete 15.62, last modified on March 19, 2024

About Support

TestComplete can recognize Developer Express XtraGrid controls in .NET applications. It provides special properties and methods that let you retrieve the controls data and simulate user actions on the controls (see below).

Supported Versions

Supported component versions: Developer Express XtraGrid ver. 3, 6.x, 7.x, 8.2 - 18.1.3, 19.1.3, 20.1.6, 21.1.3.

Requirements

In order for TestComplete to be able to work with Developer Express XtraGrid controls, the following requirements must be met:

  • You must have an active license for the TestComplete Desktop module.

  • The control’s class name must be specified in the Developer Express Controls | WinForms | XtraGrid group of your project’s Object Mapping options. By default, this group contains the following items:

    • DevExpress.XtraGrid.GridControl
    • DevExpress.XtraSpreadsheet.MailMergeParametersGrid
    • DevExpress.XtraGrid.GridControl

    You can also command the test engine to recognize custom controls as Developer Express XtraGrid controls. See below for information about this.

  • Support for the Developer Express XtraGrid controls is implemented by the Developer Express Control Support plugin. This plugin is installed and enabled automatically as part of the TestComplete Desktop module.

    If you experience issues when working with the controls, select File > Install Extensions from the TestComplete main menu and check whether the plugin is active. (You can find the plugin in the Common group.) If the plugin is not available, run the TestComplete installation in the Repair mode.

Recognizing Custom Controls

To command TestComplete to recognize your custom controls as Developer Express XtraGrid controls:

  1. Open your project’s Object Mapping options.

  2. Add the control’s class name to the Developer Express Controls | WinForms | XtraGrid group.

    If you do not know the control’s name, you can ask the control’s developers, or you can view the control’s ClrFullClassName property in the Object Browser panel. As an alternative, you can click Add From Screen and select your custom control on screen. TestComplete will retrieve the control’s class name and add it to the selected mapping group automatically. For detailed information, see Object Mapping.

Once the control is mapped, it gets all the properties, methods and actions specific to the Developer Express XtraGrid control.

If the specified custom control does not fit the control’s type, then it may not properly respond to commands that TestComplete sends, so recording or playing back user actions over the tested control will cause errors.

Members

When testing Developer Express XtraGrid controls, you can use properties and methods specific to these controls, as well as properties and methods that TestComplete applies to tested objects, onscreen objects and window objects. For the full list of available properties and methods, see the following topics:

Typical Tasks

For examples that demonstrate how to perform typical operations over Developer Express XtraGrid controls, see Working With Developer Express XtraGrid.

Note: As for custom views that are not inherited from any of the above-mentioned views, TestComplete can only interact with them via clicks and keystrokes. In addition, you can use XtraGrid’s internal members to perform the desired actions over these custom views (see Working With Developer Express XtraGrid - Overview).

Example

TestComplete includes a sample that demonstrates how to work with Developer Express XtraGrid controls:

<TestComplete Samples>\Desktop\Working With Grids\DevExpress XtraGrid

Note: If you do not have the sample, download the TestComplete Samples installation package from the support.smartbear.com/testcomplete/downloads/samples page of our website and run it.

See Also

Working With Grids
Supported Developer Express Controls

Highlight search results