Project Properties - General Options

To view or modify the General project options:

• Open the Properties page of the project editor and then choose General in the list on the left of the page.

Click the image to enlarge it.

The General options group includes the following options:

• Object tree model - Specifies which window model TestComplete will use to address windows: Flat or Tree.

  The Flat model means that the direct children of a process are top-level windows and all other windows (controls) are children of the top-level windows, regardless of the actual parent-child relationship of these windows. This shortens the path needed to address child windows in scripts. The Tree model implies that TestComplete uses the actual parent-child relationship. In this model, child windows’ names are longer, but they are more natural. For more information, see the Object Tree Models topic.

  This option effects how TestComplete records window names and on how it addresses windows during the playback. The scripts created for the Tree model will not play back correctly for the Flat model and vice versa. The Flat model was used in previous versions of TestComplete, so you should select it if you need to run legacy scripts.

  When you change the Object tree model setting of the main project, TestComplete updates the Object Browser panel so that it displays the hierarchy of the processes and windows in the appropriate manner.

  To obtain the value of the Object tree model option in scripts, use the Options.Project.General.TreeModel property.

• Log location - Specifies the path to the folder that will hold log files for the given project. See About Test Log. This path can be either relative, or absolute. If the path is relative, it will be combined with the path to the project file to obtain the target folder name. If the option holds an absolute path, it will be used as is. By default, the option holds the string Log. This is a relative path, so TestComplete will post the log files to the Log subfolder of the project folder.

  You can either type the desired name or click the ellipsis button and select the desired folder in the ensuing dialog. Also, you can store the target folder name (the whole name or some part of it) to the desired environment variable and substitute the name of the variable for the stored part of the folder name. For instance, you can specify the following path to the folder: "%TEMP%\ProjectLogs\".

• Units encoding - Specifies the format that TestComplete uses to save script unit files. Possible values include ANSI, UTF-8, UTF-16 and Auto. For more information on them and on what format to choose, see Units Encoding. Note that TestComplete does not apply the specified unit format immediately. The format is applied when the unit is saved (the Auto value means the format is not changed).

• Images

  • Image format- This option specifies the format used for the following images:

    • Images posted to the test log by the Log Message and Post Screenshot keyword testing operations.

    • Images posted to the test log by the Log.Message, Log.Picture, Log.Error, Log.Warning and Log.Event scripting methods.

    • Images saved to the Stores | Regions collection by region checkpoints and the Regions.AddPicture method.

    Note:

    The option does not affect images stored by Test Visualizer. The Visualizer uses the PNG format.

    The supported formats are:

    • BMP
    • JPEG
    • PNG
    • TIFF
    • GIF
    • ICO

    To change the format or modify its settings, click the Configure button and use the ensuing Image Settings dialog. To learn more about specifying image settings, see Specifying Log Images Format.

  • Disable DWM before capturing image - This option has effect only if you use TestComplete on an operating system with the Aero theme enabled. When capturing a window’s image on these operating systems (for example, when you create a region checkpoint), you may get inaccurate results: a useless frame around the window or other artifacts. The issue is caused by the specifics of the operating system’s Desktop Window Manager (DWM) component. Enabling this option lets you avoid the issue. If the option is on, TestComplete turns off DWM composition before it captures an image and thus produces correct screenshots. Once an image is ready, DWM is turned on again.

    The option affects all TestComplete subsystems except for Test Visualizer. Test Visualizer captures window images as they are.

    Enabling this option causes the screen to blink while an image is being captured. However, this does not affect the image quality.

• Recording

  • Record user actions over tested applications only - If this option is enabled, TestComplete records only those user actions that are performed over the applications included in the Tested Applications collection of your project. Otherwise, TestComplete records user actions performed over all the applications running in the system during test recording.

    Note:

    You can also specify the value of this property while creating a project via the Create New Project wizard.

The default values of the general properties that will be used in new TestComplete projects are specified by the Default Project Properties - General Options dialog.

See Also

Object Tree Models
Units Encoding
Default Project Properties - General Options
Project Properties