Screen Capture Pane (Options Dialog Box > GUI Testing Tab)

Relevant for GUI tests and components

This pane enables you to control how UFT captures images and movies of the application being tested.

To access

Select Tools > Options > GUI Testing tab > Screen Capture node.

Important information

  • The Restore Factory Defaults button resets all Options dialog box options to their defaults.
  • Vista/Windows 7/Windows 8 users: In addition to the options described below, if your Windows color scheme (or theme) is set to Aero, UFT automatically sets it to Vista/Windows 7 Basic while capturing movies of a run session to maximize performance. The color scheme is returned to its previous settings when the run session ends.

For movies, see Save movie to results, below.

This pane contains the following user interface elements:

UI Element

Description

Save still image captures to results

Instructs UFT when to capture still images of the application during the run session and save them in the run results. When images are available in the run results, UFT displays them in the step summary information in the run results.

  • Always. Captures images for all steps in the run.
  • For errors. Captures images only for failed steps. This is the default setting.
  • For errors and warnings. Captures images only for steps that return a failed or warning status.

Note: This setting also affects the availability of other information displayed in the run results, such as:

  • XML checkpoint and output value result details
  • Bitmap checkpoint images (expected, actual, and, if relevant, difference)
Save movie to results

Instructs UFT when to capture a movie of the application during the run session and save it in the run results. When movies are available in the run results, UFT displays a link to open and play the movie.

This option is disabled by default.

Select the check box to enable this option and then select an option from the list:

  • Always. Captures a movie of all steps in the run.
  • For errors. Captures movies only for failed steps.
  • For errors and warnings. Captures movies only for steps that return a failed or warning status.

Important:

  • Recording only on primary monitor: The Screen Recorder records a movie of the operations performed on your primary monitor. Therefore, if you are working with multiple monitors, make sure that your application is fully visible on your primary monitor when recording or running a test or component.
  • Recording entire desktop. The Screen Recorder saves a movie of your entire desktop. You can prevent the UFT window from partially obscuring your application while capturing the movie by minimizing UFT during the run session.
  • a
Save movie segment up to __  KB prior to each error and warning

Instructs UFT to save movie segments for each error (or warning). Each segment contains the specified number of kilobytes of the movie prior to the failed (or warning) step. You can enter any value from 400 (0.4 MB) to 2097152 (2 GB). If more than one segment is captured for a run session, UFT stores a single movie comprised of all the relevant movie segments.

Note: This option is enabled only when For errors or For errors and warnings is selected in the Save movie to results option.

Save movie of entire run

Instructs UFT to save a movie of the entire run if at least one error (or warning) occurs.

Note: This option is enabled only when For errors or For errors and warnings is selected in the Save movie to results option.

Record sound

Instructs UFT to save sound with the movie of your application.

Set plain wallpaper

Sets the wallpaper of your desktop to a solid blue color for the duration of the run session.

Do not show window contents when dragging windows

Instructs Windows to display only the outline of a window, without its contents, whenever the window is dragged during the run session.

Install/Uninstall button

Installs or uninstalls the Screen Recorder Capture Driver. The Screen Recorder Capture Driver improves the performance of the Screen Recorder during movie recording.

Note: The Screen Recorder Capture Driver cannot be installed or uninstalled when running UFT via a remote connection.