Java Swing Tree Support

Applies to TestComplete 15.65, last modified on July 17, 2024

About Support

TestComplete can recognize Java Swing Tree controls in Java applications. It provides special properties and methods that let you retrieve the controls data and simulate user actions on the controls (see below).


  • A license for the TestComplete Desktop module.

  • The Java Control Support plugin. This plugin is installed and enabled automatically.

    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 Desktop group.) If the plugin is not available, run the TestComplete installation in the Repair mode.

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

    • javax.swing.JTree

    You can also command the test engine to recognize custom controls as Java Swing Tree controls. See below for information about this.

If the tested Java application uses the Windows look and feel (, you must run your application with the swing.disablevistaanimation command-line parameter set to True, or specify the parameter in the application code. Otherwise, your tests may work incorrectly. For detailed information, see Requirements for Testing Java Applications.

Recognizing Custom Controls

To command TestComplete to recognize your custom controls as Java Swing Tree controls:

  1. Open your project’s Object Mapping options.

  2. Add the control’s class name to the Swing Controls | Tree group.

    If you do not know the control’s name, you can ask the control’s developers, or you can view the control’s JavaFullClassName 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 Java Swing Tree 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 Java Swing Tree controls, you can use properties and methods specific to these controls, as well as properties and methods that TestComplete applies to onscreen objects. For the full list of available properties and methods, see the following topics:

See Also

Support for Java Applications' Controls
Working With Tree View Controls in Desktop Windows Applications

Highlight search results