Default Project Properties - Debug Agent Options

Applies to TestComplete 15.69, last modified on November 13, 2024

The Open Applications | Debug Agent properties specify Debug Info Agent™ settings for the project. The Agent exposes private, public and protected elements of applications created in Microsoft Visual C++, Borland Delphi, CodeGear Delphi, Embarcadero Delphi, Borland C++Builder, CodeGear C++Builder and Embarcadero C++Builder. In order to use the Agent with an application, this application must be compiled with debug information. For instructions on doing this in various development tools, see Implementing Debug Info Agent™ Support in Applications.

To view or change these default options, select Tools | Default Project Properties from the main menu of TestComplete and then choose Project | Open Applications | Debug Agent from the tree on the left of the ensuing Default Project Properties dialog.

You can change the following options --

  • Enable Debug Agent - Defines whether the Agent should be enabled for the current project. If the option is enabled, then the application compiled with external debugger information, would be accessed as a plain Open Application. Turning this option off is equivalent to specifying the /DisableDebugAgent key in the application’s command-line.

  • Advanced exception handling - Specifies how the Debug Agent should process exceptions that occur during an application’s function calls. If this option is enabled, the Debug Agent generates detailed information about these exceptions. You can use this information in the exception handling blocks. For more information on exception handling, see Handling Exceptions in Scripts. If this option is disabled, the Debug Agent does not generate any information about exceptions.

  • Read debug information for statically linked libraries - Specifies whether the Agent should attempt to read debug information from the libraries that are linked to the application at load-time. The libraries should include the debug information in order to use the Debug Agent, otherwise data is not read.

  • Maximum string length of [out] parameters - Specifies the maximum length of a string that can be received by TestComplete from the tested application. If the length or the string returned from the application via one of its out parameters exceeds the property’s value, TestComplete treats the returned string as a null one.

To save the changes you made to the options and close the dialog, press OK. Cancel will close the dialog discarding any changes.

See Also

Debug Info Agent
Project Properties - Debug Agent Options
Default Project Properties - Project Options

Highlight search results