Creating Region Checkpoints

1. Launching the Wizard

2. Specifying the Image to Check

3. Specifying a Comparison Mask

4. Specifying Comparison Parameters

5. Closing the Wizard

Connecting to Mobile Device Clouds and Opening Testing Sessions

Preparing for Android Testing (Legacy Mobile Support)

Preparing for iOS Testing (Legacy Mobile Support)

Preparing for Xamarin.Forms Testing (Legacy Mobile Support)

The way you open the wizard depends on the test creation mode:

• If you are recording a test, on the Recording toolbar, click Add Check. In the resulting Checkpoint Wizard, click the Image property, and then click Next:

  

  Click the image to enlarge it.

• If you are editing a keyword test, drag the Checkpoint Wizard or Region Checkpoint operation to your test. You can find them in the Checkpoints category in the Operations panel of the Keyword Test editor. If you add the Checkpoint Wizard option, in the ensuing Checkpoint Wizard dialog, click Image:

  

• If you are editing a script, click on the Code Editor toolbar. In the Checkpoint Wizard, select Image, and then click Next:

  

You can specify the image in one of the following ways:

Click the image to enlarge it.

• Pick the object with the target icon ()

  See instructions

  See instructionsSee instructions

  1. Drag the target icon () to the desired onscreen object in the tested application.

     To select an object in a mobile application, drag the target glyph to the desired object on the Mobile Screen (see Select an Object on the Mobile Screen).

     Select an object in a mobile device cloud

     Select an object in an Android application (Legacy mobile support)

     Select an object in an iOS application (Legacy mobile support)

  2. While dragging, a red frame appears around the object that is currently under the mouse pointer.

  3. Wait until a red frame appears around the needed object and release the mouse button.

  Watch video: Selecting Objects: 'Drag the Target...' Mode

• Select the object and press a shortcut ()

  See instructions

  See instructionsSee instructions

  1. Click icon.

  2. Perform the actions needed to activate the desired object in the tested application (for example, invoke the popup window).

  3. Move the mouse pointer over the desired object.

     To select an object in a mobile application, move the mouse pointer over the desired object on the Mobile Screen (see Select an Object on the Mobile Screen).

     Select an object in a mobile device cloud

     Select an object in an Android application (Legacy mobile support)

     Select an object in an iOS application (Legacy mobile support)

  4. Wait until a red frame appears around that object and press Shift+Ctrl+A. (The shortcut can be changed in the Global Shortcuts options.)

  Watch video: Selecting Objects: 'Point and Fix' Mode

• Select an arbitrary region ()

  See instructions

  See instructionsSee instructions

  1. Click the icon.

  2. Use the crosshairs pointer to draw the rectangle indicating the area that you want to verify.

     To verify an area within an object in a mobile application, draw the desired area in the Mobile Screen window.

  TestComplete will display the name of the object, to which this area belongs, in the Object box.

• Enter the object name manually

  Enter the full name (or full mapped name, or alias) of the desired object into the Object box.

  For web objects: If your project is configured to use XPath expressions and CSS selectors to locate web objects, the dialog will show the list of available locators (if any) for the specified web object. You can select the needed locator from the drop-down list.

Tips for selecting objects:

• You may find the second technique more convenient than using the target icon, because you can manipulate applications before actually selecting an object. For example, you can open the tested application window containing the desired control and so on. Unlike using the target icon, with this technique, you can point to popup windows, tooltips, and other objects that are hidden in the application when being inactive.

• Instead of selecting the object, you can copy its name from the Object Browser, Object Spy, keyword test, or script code beforehand and paste it into the Object box.

• Despite the way you specify the object name, you can change or correct it directly in the Object box.

If the Map object names automatically option is selected, TestComplete automatically adds the specified object to the Name Mapping repository (if it is not there already). Your tests will take the object alias from the repository.

In the Stores object name text box, enter the image name. The default name generated by TestComplete is based on the name of the captured object.

Once you have selected the object or object area to verify, click Next to proceed.

On the next page of the wizard, you can select an image comparison mask. It will specify the parts of the region to include in and exclude from verification:

Click the image to enlarge it.

Option	Description
Don’t use comparison mask	Use if you don’t want to apply a comparison mask.
Use existing comparison mask	Use to load an existing mask from a file. See instructions See instructionsSee instructions Select Use existing comparison mask. Specify the path to the file that you want to use as a comparison mask. You can type the file path manually or you can click the ellipsis button and browse for the needed file in the resulting dialog. The file must contain black and white pixels only. You can also click the down-arrow button and select one of the comparison masks existing in your project (if any).
Create new comparison mask	Use to add a new mask for your validation. See instructions See instructionsSee instructions Select Create new comparison mask. Enter the mask name. Specify the pixels to include into or exclude from the comparison: To exclude one or several pixels from the comparison, click and then click the desired pixel in the image, or click and drag the mouse pointer to mark a number of pixels to be ignored. To add one or several pixels to the comparison, click and then click the desired pixel in the image, or click and drag the mouse pointer to add pixels to the comparison. To select the area you want to exclude from or add to comparison, use or . To exclude the selected area from comparison, use . To add the selected area to comparison, use . To change the image scale, use , and . To undo and redo changes, use and . To restore the original comparison mask, use . To specify whether excluded areas are displayed or not, use  Show Excluded Areas. When the button is pressed (by default), ignored areas are shown semitransparent, otherwise they are not shown.

Click Next to proceed.

On the next page of the wizard, specify the comparison parameters of the checkpoint:

Pixel Tolerance

This parameter specifies the number of allowed different pixels. The default value is 0. It means that the comparison procedure will ignore slight differences between the images during the comparison. If the number of different pixels is less than or equal to the Pixel Tolerance value, TestComplete considers the images identical.

You can specify the value of the Pixel Tolerance parameter either by typing the desired value in the edit box or by dragging the slider on the right of the edit box.

Color Tolerance

If you specify a non-zero value in this edit box, the color dissimilarity between images will be ignored. The allowed difference is specified as an integer value within the range 0…255 that represents an acceptable difference for each color component (red, green, and blue) of the compared pixels. Two pixels are considered identical if the difference between intensities of each of their color components does not exceed the specified value. When ColorTolerance is 0, the compared pixels are considered identical only if they have exactly the same color. When ColorTolerance is 255, pixels of any color are considered identical.

You can specify the value of the Color Tolerance parameter either by typing the desired value in the edit box or by dragging the slider on the right of the edit box.

Click Finish to exit the wizard. TestComplete will add the checkpoint statement for the specified image to your test.

If you are creating a region checkpoint while editing a test script, then the generated checkpoint code will be displayed in the Copy Text to Clipboard dialog. You will be able to copy this code to the clipboard and then paste it to the desired place in your script.