Developer Express ExpressNavBar Support

Applies to TestComplete 15.47, last modified on January 20, 2023

About Support

TestComplete can recognize Developer Express ExpressNavBar controls in Delphi and C++Builder 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 ExpressNavBar ver. 1.4.5, 1.41, 1.49, 2.41, 2.49, 11.1.4 - 15.1.4, 18.1.3, 19.1.2, 20.1.3, 21.1.2.

Requirements

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

  • The tested Delphi or C++Builder application is compiled with debug information (see Implementing Debug Info Agent™ Support in Applications).

    By default, Developer Express VCL components for C++Builder are compiled and distributed without debug information. Therefore, TestComplete cannot obtain access to properties and methods of such VCL controls used in the tested C++Builder Open Application. However, you can re-compile Developer Express VCL components for C++Builder with debug information and then use them in C++Builder Open Applications tested by TestComplete. To learn how to prepare these components for C++Builder applications, see Preparing Developer Express VCL Components for C++Builder Applications.
  • The control’s class name must be specified in the Developer Express Controls | VCL | ExpressNavBar group of your project’s Object Mapping options. By default, this group contains the following items:

    • TdxNavBar

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

  • Support for the control is implemented by the Delphi and C++Builder Open Applications Support and Developer Express Control Support plugins. These plugins are installed and enabled automatically if you choose to install the Desktop module in the TestComplete installation wizard.

    If you experience issues when working with the controls, select File | Install Extensions from the TestComplete main menu to check whether the plugins are active. If the plugins are not available, run the TestComplete installation in the Modify mode and select the Desktop module for installation in the installation wizard.

Recognizing Custom Controls

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

  1. Open your project’s Object Mapping options.

  2. Add the control’s class name to the Developer Express Controls | VCL | ExpressNavBar group.

    If you do not know the control’s name, you can ask the control’s developers, or you can view the control’s ClassName 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 ExpressNavBar 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 ExpressNavBar 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:

See Also

Supported Developer Express Controls

Highlight search results