Post Screenshot Operation

Specifies the window, control or its area whose image you wish to post to the log.

Note for mobile testing: To post the image of a tested mobile object, specify the desired object by selecting it on the Mobile Screen (make sure the Mobile Screen is visible upon selecting the object). Note that the mobile application, to which the target object belongs, and the mobile device, where the application is running, must be prepared for testing.

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

• Pick the object using the target glyph

  Drag the target glyph () to the desired window or control.

  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 on the Mobile Screen (for Android Applications)

  Select an Object on the Mobile Screen (for iOS Applications)

  While dragging, a red frame indicates the object that is currently under the mouse pointer. Once the frame appears around the desired object, drop the glyph.

• Point to the object and fix

  Click the button and move the mouse pointer to the desired window or control.

  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 on the Mobile Screen (for Android Applications)

  Select an Object on the Mobile Screen (for iOS Applications)

  While moving, a red frame indicates the object that is currently under the mouse pointer. When the frame appears around the desired object, press the Select object shortcut, Shift+Ctrl+A (this shortcut can be changed in the Global Shortcuts dialog).

• Select arbitrary object area

  Click the button and use the crosshairs pointer to draw the rectangle indicating the object area that you want to capture.

• Enter object name manually

  Enter the full name, full mapped name or alias of the desired object into the Object box and press Enter.

  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.

In the Preview area, you can preview the captured image. To highlight the selected object on the screen, click Highlight.

If the Map object names automatically setting is enabled, TestComplete will automatically create a mapped name for the selected object (if it does not have one yet) and display this name instead of the default one in the Object box.

A constant, variable, test parameter or the [Last Operation Result] value that contains one of the following:

• The full-name of the scripting object that corresponds to a window or control.

• A Picture object reference.

Text that will be posted to the log along with the image (same as the Message parameter on the Select Object page). This text will be added to the Message column of the test log.

Additional text to be posted to the log along with the image (the same text that is specified on the Details parameter of the Select Object page). This text will be displayed in the Details pane of the test log.

Priority of the image message. You can use any integer number or any of the following constants:

For information on specifying the Priority parameter value, see Specifying Enumeration Values in Parameters.

A LogAttributes object that contains the font and color attributes to be applied to the message in the test log.

You can create this object by using the Log Attributes operation or script code. In the latter case, to specify the parameter, you should use a script expression that returns a reference of the LogAttributes object or use a variable, test parameter or [Last Operation Result] value that contains the object reference.

If this parameter is omitted, default attributes will be applied.

Identifier of the test log’s folder to which the image will be posted. This can be, for instance, the identifier of the folder created by the previous Append Log Folder operation, or the identifier returned by the Log.AppendFolder or Log.CreateFolder scripting method.

If this parameter refers to a non-existent folder, is omitted or is set to -1 (the default value), the operation will post the image to the currently active folder.