As explained on the introductory page to this chapter, Ranorex Spy has two working environments: the browser & results screen and the path editor. On this page, you’ll find out how the former works and what it is used for.
In this chapter
The element tree browser is on the left side of the working environment by default. It’s a hierarchical representation of running applications and their UI elements. By default, it displays all applications that are running on an endpoint (i.e. machine) and whitelisted in Ranorex Studio. However, you can also display only a certain application or node.
The functions of the tree browser are explained further below.
Element tree browser displaying ALL running and whitelisted applications.
Element tree browser displaying only the application
RxMainFrame, which is the Ranorex Studio Demo Application.
The area above the element tree browser contains several buttons and a status indicator. The button layout differs slightly between the standalone and the integrated Spy. The difference is indicated below in the captions.
Browse endpoint and Endpoints (only in standalone Spy)
Load from snapshot… and Save as snapshot…
Displays the status of the element tree browser. Three statuses are possible:
Live display mode
The tree represents the applications of the currently active endpoint.
Live edit mode
You are editing an element of the currently active endpoint.
The tree was loaded from a Ranorex snapshot, which represents a static snapshot of an endpoint’s applications.
Click the Endpoints button in the toolbar.
The endpoints pad opens.
Endpoints are explained in
Web and mobile testing > ⇢ Endpoints.
Ranorex snapshots are explained in
Ranorex Studio advanced > Ranorex Spy > ⇢ Snapshot files.
This function is the same as the one in the repository toolbar. It highlights the selected element in the UI of the actual application with a red frame. Naturally, the application must be running for this to work.
Click the Highlight elements button.
The element is highlighted with a red frame in the application.
In addition to the toolbar buttons, right-clicking an element in the tree brings up a context menu that offers many further options.
Highlights the element in the application. Explained in the previous topic.
Update element data
Refreshes the element. Explained in the previous topic.
Set element as root
Makes the element the root of the element tree browser.
In the tree, select the UI element you want to set as root.
In the context menu, click Set element as root.
The tree now has the element as root.
Add to repository
Save as snapshot…
Saves the element to a snapshot file. Explained in the previous topic.
The details area lists all properties and attributes of a selected UI element.
Primary adapter and name of element
Switch between the overview and advanced details.
Area where the details are displayed.
UI elements and their details, i.e. properties and attributes, as well as the concept of adapters are explained in
Ranorex Studio advanced > ⇢ UI elements.
Edit path weights…
Opens a menu that allows you to configure the mapping of dynamic UI elements.
Mapping dynamic UI elements is explained in
Ranorex Studio expert > ⇢ Mapping dynamic UI-elements.
The image navigation area shows the UI the selected element is part of. You can navigate through the UI as if you were in the application. When you click a UI element in the image, it will be selected in the tree.
Click a UI element in the image.
The corresponding tree element is selected.