During Recording

Click the 'Record' button to trigger a new recording.

: Click 'Record' to start recording

After clicking the record button you get assistance in running an application or opening a browser to navigate to a particular URL before recording any user performed actions. Therefore it’s not necessary to record actions like double clicking a shortcut on the system’s desktop.

: 'New Recording' dialog

Note: If you select 'Record a Website' or 'Record an Application' the recording is not limited to the application or browser.

After clicking the 'Start' button the Recorder or Ranorex Studio will be minimized. A running recording session is indicated by the Ranorex Recorder tool bar.

: Ranorex Recorder toolbar

Now perform all the actions you want to be part of the automated test. You can also pause the recording session at any time by clicking the ‘Pause’ button.

Validation

The Ranorex Recorder provides two different types of validation during a running recording session.

Validation based on property values of a UI element
Image based validation

Validating States or Properties

The Ranorex Recorder tool bar can be used to validate states or properties of GUI elements during a running recording session. Click the 'Validate' button to pause the recording.

: Validation mode is active

Recording is now paused. Move your mouse pointer over a specific UI element. Wait a moment to ensure that the text box is tracked and ready to be validated. Click it to open the validation dialog.

: The highlight frame specifies the element to validate

: The dialog shows the available attributes to check

To validate UI elements of pop-up windows like menus, use the shortcut key 'V' to turn on validation mode without clicking the 'Validate' button. Read more about how to enable the Recorder's hot keys here.

: Validation of menu items

Validating Images

In addition to validating attribute values of a UI element, it is also possible to validate images or screen regions of an application. Simply switch to validation mode as described above and select a UI element. To validate the element's image, open the 'Image' tab in the validation dialog.

: Validate the existence of an image region within the screenshot of Windows start button

Recorder Hotkeys

Ranorex Recorder provides useful hot keys for triggering special features like validation or the recording of simple mouse movements. When you start a new recording session, the hot key functionality is turned off. To activate the Recorder's hot keys simply click on the 'Enable Hotkeys' checkbox or press the master hot key <SCROLL>.

The recorder's toolbar will then shows what type of shortcut keys are available.

: Available hot keys during recording session

'V':
Press the hot key 'V' to turn on validation mode - especially useful for validating elements of a pop-up window like menu items and drop-down lists.

'M':

Use the hot key 'M' to record simple mouse movements. Simply move the mouse pointer to a certain position and press the hot key to record the mouse movement in relation to the underlying UI element.

'T':

It's easy to validate the content of a tooltip by pressing the hot key 'T' after the tooltip box appears. Ranorex Recorder automatically captures a mouse move action to the underlying item and validates the current content of the tooltip.

'I'

The hot key 'I' is used to turn on/off image based recording - used for pop-up windows, menu items or drop down lists.

'Roll Mouse Wheel'

Roll the mouse wheel during validation mode to change the level of UI element selection.

Online User Guide
download as: PDF (20.3MB)

Ranorex Tutorial
(PDF file, 13.5MB)

Online API Documentation