Configuration

This Documentation is only for Ranorex 2.x versions.

Click here for the Ranorex 3.x test automation documentation

Click the 'Configuration' button

to open the Recorder's settings dialog.

: General settings

: Recorder default values

: Current Recording

: Image search default values

General Settings

The general settings are not only related to the Recorder's behavior but also to how the Repository generates its object items.

Use Ensure Visibilty by default	That setting causes an element to ensure the visibility on the GUI before an action like a simple mouse click will be executed on it
Length of Text Values	Specifies the maximum length of attribute values used within RanoreXPath
RanoreXPath search depth	Defines the number of RanoreXPath levels required for a unique identification. Note: The higher the value, the shorter the RanoreXPath strings are generated. But keep in mind that the shorter the path the longer it takes to find the expected UI element.
Delay before pressing a Keysequence	Specifies how long to wait before performing a key sequence simulation

Use the checkbox 'Enable 32/64 bit bridge' to turn off the bit bridge required to handle 32/64 bit based applications on 64 bit operating systems automatically.

Current Recording

This tab primarily contains configuration parameters for code generation specific to the current recording. Additionally it provides a check box to turn on generation of replay reports. These settings are stored within each recording.

Recorder Defaults

The 'Recorder Defaults' tab enables one to configure user specific global default values. A default namespace for code generation can be defined here or the recorder can record relative coordinates for each mouse action.

In addition the default values for mouse move time, keyboard-related action time or duration time of manually added mouse actions can be defined here. There is also a setting available to specify when the Recorder should split key sequences into smaller ones. These settings are stored globally and valid for each newly created recording.

Default Image Find Options

Use the dialog to set default values used for image based search or image validation actions. Read more about the different options used for finding images here.

The replay and code generation settings affect the generated code as follows:

C#

// represents the default values
// within configuration dialog
Mouse.DefaultMoveTime = 300;
Keyboard.DefaultKeyPressTime = 100;
// represents the recordings speedfactor
Delay.SpeedFactor = 3.0;

// if the current replay speed
// is set to Turbo mode ...
Mouse.DefaultMoveTime = 0;
Keyboard.DefaultKeyPressTime = 20;
// Represents the recordings speedfactor
Delay.SpeedFactor = 0.0;

VB.NET

' represents the default values
' within configuration dialog 
Mouse.DefaultMoveTime = 300
Keyboard.DefaultKeyPressTime = 100
' represents the recordings speedfactor
Delay.SpeedFactor = 3

' if the current replay speed
' is set to Turbo mode ...
Mouse.DefaultMoveTime = 0
Keyboard.DefaultKeyPressTime = 20
' Represents the recordings speedfactor
Delay.SpeedFactor = 0

Python

# represents the default values
# within configuration dialog
Mouse.DefaultMoveTime = 300
Keyboard.DefaultKeyPressTime = 100
# represents the recordings speedfactor
Delay.SpeedFactor = 3

# if the current replay speed
# is set to Turbo mode ...
Mouse.DefaultMoveTime = 0
Keyboard.DefaultKeyPressTime = 20
# Represents the recordings speedfactor
Delay.SpeedFactor = 0