Working With Visualizer Frames

To view frames at a larger scale

To add frames

To delete frames

To update frames

To create an action from a frame

To copy frames to the clipboard

To copy a part of the image

To save a frame or part of it to a file

1. Right-click the desired frame in the Test Visualizer panel and select View from the context menu. This will open the Visualizer Frame window.

2. In the window, use the Zoom slider to set the desired view scale. Alternatively, to change the display scale, use the + and - keys or rotate the mouse wheel while holding the Ctrl key pressed.

TestComplete adds frames to tests automatically during test recording or during the test run.

To add frames to your existing test:

1. Before running your test, select Tools | Current Project Properties from the TestComplete menu.

2. Select the Visualizer category.

3. To configure Visualizer to add frames during test runs, select the Auto-update frames during the run check box.

4. Click Update existing frames and capture new frames, if needed to add frames to the existing tests.

5. Run the tests to which you want to add frames.

When you are removing a keyword test operation or a script line for which the Visualizer frame was recorded, TestComplete automatically removes this frame from the project.

To delete a frame without deleting the keyword test operation or script line, right-click the needed frame in the Test Visualizer panel and select Delete from the context menu.

To delete all Visualizer frames of the currently open project:

1. Open the project’s Properties page by doing any of the following:

   • Double-click the project in the Project Explorer panel. In the ensuing project editor, switch to the Properties page.

     – or –

   • Right-click your project in the Project Explorer and select Edit | Properties from the context menu.

     – or –

   • Select your project in the Project Explorer and then select Tools | Current Project Properties from the main menu of TestComplete.

2. In the list on the left of the Properties page, select Visualizer.

3. Click Delete all Visualizer frames button and click Yes in the following dialog. All the frames that were saved for script routines and keyword tests will be removed from the current project. They will be deleted from the disk after you save the changes made to the project.

Another way to delete all the frames is to right-click within the Test Visualizer panel, to select Select All from the context menu and to press Delete.

When you are editing a script unit, the Test Visualizer panel displays frames that were captured for all script routines of this unit, not just for the routine you are editing. So, deleting all Visualizer frames means deleting them for the entire script unit, not just for one routine. Be aware!

To save changes after deleting frames, select File | Save All from the TestComplete main menu. That is, these changes can be saved along with other changes made to the project. You cannot save them separately.

Enable the Update check box in the top left corner of the frame's area in the Test Visualizer panel. TestComplete will update the marked frame during the next test run.

– or –

Make sure the Auto-update frames during the run project option is enabled, then run the test whose frames need to be updated. For detailed information on updating frames, see Updating Visualizer Frames.

You can add keyword test operations for objects that are displayed on frames on the Test Visualizer panel. For detailed information on this, see Creating Test Commands From Visualizer Frames.

Right-click the desired image in the Test Visualizer panel and select Copy from the context menu. TestComplete will save the image to the clipboard.

To copy a frame from the Visualizer Frame window:

1. Right-click the desired image in the Test Visualizer panel and select View from the context menu. This will invoke the Visualizer Frame window.

2. In the window, click Copy on the toolbar. TestComplete will copy the image to the clipboard.

1. Right-click the desired image in the Test Visualizer panel and select View from the context menu. This will invoke the Visualizer Frame window.

2. In the window, click Select Mode on the toolbar or press Ctrl+2. This will activate the selection mode.

3. Click the left mouse button within the image area and do not release the mouse button. The click coordinates indicate the top-left point of the area you would like to copy.

   Drag the mouse pointer to select the desired rectangle. Release the mouse pointer at the bottom-right point.

4. Click Copy on the toolbar of the Visualizer Frame window. TestComplete will copy the selection to the clipboard.

1. Right-click the desired image in the Test Visualizer panel and select View from the context menu. This will invoke the Visualizer Frame window.

2. In the window:

   To save the entire image:

   • Click Save To File on the toolbar or press Ctrl+S. This will invoke the standard Save File dialog.

   • Specify the file name and extension in the dialog and click Save.

   • TestComplete will save the image to the specified file.

   To save a part of the image:

   • Click Select Mode on the toolbar or press Ctrl+2. This will activate the selection mode.

   • Click the left mouse button within the image area and do not release the mouse button. The click coordinates indicate the top-left point of the area you would like to copy.

     Drag the mouse pointer to select the desired rectangle. Release the mouse pointer at the bottom-right point.

   • Click Save to File on the toolbar of the Visualizer Frame window or press Ctrl+S. This will invoke the standard Save File dialog, in which you can specify the file name and extension. TestComplete will save the image to the specified file after you click Save in the dialog.