General Ranorex Settings

There are three ways to open the 'Settings' dialog for adapting general Ranorex automation and identification settings:

  • Clicking 'Settings' button within Ranorex Spy
  • Clicking 'Settings' button within Ranorex Recorder
  • Clicking 'Global Settings' button within Ranorex Studio
Open 'Settings' dialog from Recorder
Open 'Settings' from Recorder
Open 'Settings' dialog from Spy
Open 'Settings' from Spy

General settings

General Ranorex settings
General Ranorex settings

'Use Ensure Visible by default'

Specifies whether a UI element used as Ranorex Adapter should be forced to become visible before automation or not. By default this value is automatically used for each repository item.

'Maximum length fo text values in RanoreXPaths'

Specifies the maximum length of attribute values used within RanoreXPath.


'The factor that all timouts of find operations are multiplied with'

Multiplies all repository timeouts with the specified value to prevent test cases from failing in case of different timing behavior. This is especially useful when executing tests on different system configurations.

Note: The value can also be set at the time of executing a test suite using the test suite's command line arguments or by directly using the 'Ranorex.Core.Configuration.Current.Adapter.TimeoutFactor' property in code.

'Reset not shown technology specific limitations'

Resets 'Do not show again' checkbox used to suppress assistance dialog for technology limitations. Click 'Reset' to show the dialog again for not instrumented technologies or applications.

Advanced Settings

Most of the settings shown in the 'Advanced' group box are used to configure Ranorex object recognition and RanoreXPath generation. Please be careful when changing these settings.

'Enable 32/64 Bit Bridge'

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.

'Disable expensive attribute in tools'

This setting instructs plug-ins not to evaluate computationally intensive attributes for Ranorex Spy, Recorder, and Ranorex Studio. If checked, attributes like Row.Index do not have a value for certain technologies when shown in Ranorex Spy, that way speeding up performance.

'Use asynchronous dispatching of mouse and keyboard events'

This setting is used to turn on or off dispatching of mouse and keyboard events during recording.

'Use hidden screenshot capturing (if possible)'

Tries to create screenshots used for recordings, repositories or Ranorex snapshot files also for hidden applications.

'Delay before pressing a key sequence (ms)'

Specifies the time to wait in milliseconds before performing a key sequence simulation.

'RanoreXPath generation tree search depth'

Defines the number of unique 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.

'GDI Capture Settings...'

Opens the dialog to change the current GDI capture list. More information about the Ranorex GDI Plug-In can be found here.

'Edit Path Weights...'

In order to get assistance with editing RanoreXPath Weights, contact the Ranorex support team.

Click the button 'Restore Defaults' to reset all values to their default values. Use the 'Import...' and 'Export...' buttons to save and load user specific configurations.

Plug-in specific settings

Plug-In specific settings
Plug-in specific settings can be used to alter the behavior of individual Ranorex plug-ins, for example, to achieve backwards-compatibility with older versions. For more information on each setting, read the description shown when you click on a particular setting in the property grid.