When tracking and identifying UI elements, Ranorex Studio also categorizes them according to their purpose and to define their states. The categories Ranorex Studio uses are roles, capabilities, characteristics, and attributes.
Ranorex Studio chooses these categories based on a best-guess method. If it can’t categorize an UI element, it classifies it as Unknown.
This page explains how the categorization process works, which roles, capabilities, and characteristics there are, and where in Ranorex Studio you can find them.
In this chapter
Ranorex Studio follows a certain order when categorizing UI elements and assigning roles, capabilities, etc. The image below shows this:
Technology-independent role assignment
Roles define how a user can interact with an UI element, i.e. the UI element’s purpose. Below you can see a table of predefined roles in Ranorex Studio. These are technology unspecific and cover the most common UI elements. The Unknown type is for when Ranorex Studio can’t assign an adequate role based on its algorithm.
For a quick example of an assigned role, simply take a look at a repository item’s RanoreXPath or select a UI element in the tree browser in Ranorex Spy.
Radio button for gender selection in AUT.
Corresponding repository item named
RdbFemale in the repository.
Assigned role in the item’s RanoreXPath.
Spy displaying the UI element with the assigned role outside quotes in the UI element name (element tree)
Spy displaying the UI element with the assigned role outside quotes in the UI element name (element details)
Based on the role, Ranorex Studio derives a set of characteristics. They in turn contain sets of attributes that define the UI element in more detail. The number and type of characteristics varies depending on the role. The following image shows an example for a set of characteristics for the role Radio button.
When a UI element has been implemented with extended functionality by the developer, the corresponding attributes are contained in this category.
You can view characteristics and their attributes in Ranorex Spy under the Overview and Advanced tabs in the element details.
Attributes overview: shows a summary of the currently available and assigned attributes of the UI element.
Attributes advanced view: shows the attributes in detail and lets you edit them.
Aside from the role-specific characteristics above, Ranorex Studio also assigns technology-specific capabilities that in turn contain sets of attributes. Capabilities are organized in technology categories. The table below shows these categories and the number of capabilities they contain.
The Control capability, part of the WinForms technology
The four attributes this capability contains.
You can view all capabilities and attributes through the Edit path weights… menu in Ranorex Spy.
In the attributes overview in Spy, click Edit path weights….
In the displayed dialog, click Show attribute overview….
The attributes overview opens.
Attributes for each capability