Adding Images to the Regions Collection

1. Right-click the Stores > Regions node in the Project Explorer and then select Add > New Item from the context menu.

2. In the ensuing Add Image wizard, you can capture the desired image, or add the image file to your project.

1. Right-click the Stores > Regions node in the Project Explorer panel and select Edit from the context menu. TestComplete will open the Regions editor in the Workspace panel.

2. Right-click somewhere within the editor and choose New Item from the context menu.

3. In the ensuing Add Image wizard, you can capture the desired image, or add the image file to your project.

1. During test recording, click Add Check on the Recording toolbar and then select Image in the resulting wizard.

   – or–

   In a keyword test, add the Region Checkpoint operation to the test at design time.

   – or –

   In a script test, click Add Checkpoint on the Code Editor toolbar and then select Image in the resulting wizard.

2. In the Checkpoint wizard, select the object, whose image you want to store, specify the checkpoint options.

3. TestComplete will add the appropriate image of the selected object to the Regions collection automatically.

You can add an image of a window, screen or an arbitrary rectangles to the Regions collection during test recording. To do this, create a region checkpoint that will verify the desired window, rectangle or entire screen. Using the checkpoint creation wizard, you can append the current image of the window, screen or rectangle to the Regions collection. See the previous section for more information on this.

To add an image to the Regions collection from your keyword test or script, use the SaveToFile method of the Picture object. This function saves an onscreen object to an image file in one of the supported formats (the format is specified by the file extension. See the method description).

To add an existing image file from your disk, call Regions.Add. An even simpler way is to use the Regions.AddPicture method to save an image to a file and then add this file to the Regions collection.

For instance, the following code saves a region of an active window to a .bmp file in the project’s folder and adds the file to the project’s Regions collection (note that if the Regions collection already has an element with the specified name, the element’s file will be overwritten).

w = Sys.Desktop.ActiveWindow().Picture(20, 20, 50, 50)
# To save the entire window, use
# w = Sys.Desktop.ActiveWindow()
Regions.AddPicture(w, "MyFile.bmp")

Note that the above code does not depend on the window type. It can save popup windows as well as top-level ones. For more information on operations with images, see Regions Object and Picture Object.

To execute the code above and perform other operations with the Regions and Picture objects from keyword tests, use the Call Object Method, Run Code Snippet or Run Script Routine operation.

TestComplete includes a built-in image viewer that is used to display images in various situations. For instance, the Image Viewer is used to view images posted to the test log.

To add an image to the Regions collection from the Image Viewer:

• Click Add Image to Stores on the toolbar of the Image Viewer and then specify the image name in the ensuing dialog.