Borland TDBGrid Support

Applies to TestComplete 15.64, last modified on May 16, 2024

About Support

TestComplete can recognize Borland TDBGrid 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: VCL TDBGrid component of Borland Delphi 7, Borland Developer Studio 2006, CodeGear RAD Studio 2007 and 2009, Embarcadero RAD Studio 2010, XE - XE8, 10 - 10.4.


In order for TestComplete to be able to work with Borland TDBGrid controls, the following requirements must be met:

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

  • Your tested application must be compiled with debug information (see Implementing Debug Info Agent™ Support in Applications).

  • The control’s class name must be specified in the Borland Controls | DBGrid group of your project’s Object Mapping options. By default, this group contains the following item:

    • TDBGrid

    You can also command the test engine to recognize custom controls as Borland TDBGrid controls. See below for information about this.

  • Support for the Borland TDBGrid controls is implemented by the Delphi and C++Builder Application Support and VCL Control Support plugins. These plugins are 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 plugins are active. (You can find the plugins in the Desktop group.) If the plugins are not available, run the TestComplete installation in the Repair mode.

Recognizing Custom Controls

To command TestComplete to recognize your custom controls as Borland TDBGrid controls:

  1. Open your project’s Object Mapping options.

  2. Add the control’s class name to the Borland Controls | DBGrid 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 Borland TDBGrid 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.


When testing Borland TDBGrid 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 Borland TDBGrid controls, see Working With Borland TDBGrid.

Note: TestComplete lets you work only with those grid records that are currently visible. Access to records that are situated above or below the visible area is not supported. To be able to work with records that are situated out of the grid’s visible area, you should first scroll the grid so that the needed row becomes visible. To scroll the TDBGrid control, you can use any of the following approaches:
  • Call internal methods of the TDBGrid control that will select the desired record. For example, you can use the ActivateRow routine from the Searching for Records in Borland TDBGrid topic.

  • Use the VScroll property that provides scripting access to the grid’s vertical scroll bar. To scroll the grid to the desired record, assign the record’s index to the VScroll.Pos property. Note however, that this approach works only if the grid’s dataset is not filtered.


TestComplete includes a sample that demonstrates how to work with Borland TDBGrid controls:

<TestComplete Samples>\Desktop\Working With Grids\Borland TDBGrid

Note: If you do not have the sample, download the TestComplete Samples installation package from the page of our website and run it.

See Also

Working With Grids
Supported VCL and CLX Controls

Highlight search results