Ranorex Help Center How can we help you?

How to Create a Ranorex Snapshot

What is a Ranorex Snapshot?

A Ranorex Snapshot is a representation of the the user Interface (UI) structure of a system under test (SUT) at a particular Point in time. A Ranorex Snapshot captures all interface elements, their hierarchy, values, etc. 

It can be saved as a single file. A Ranorex Snapshot file can be created and viewed with Ranorex Spy. The file extension is '.rxsnp'.

Typically, Ranorex Snapshots are used to share detailed information about the UI of a SUT with the Ranorex Support and Technical Sales Team.

Create a Ranorex Snapshot

  1. Start your system under test (SUT).
  2. Start Ranorex Spy.
  3. Get to the part of your SUT you want to create a snapshot of.
  4. In Ranorex Spy, press the TRACK-Button.
    Track button
    If you move the mouse cursor over a UI element, a red border will appear around this element in tracking mode.
  5. Place the mouse cursor over the UI element of the SUT you want to track.
    Wait until the red border appears and left click your mouse button.
  6. The tracked element automatically appears in Ranorex Spy.
  7. Click on 'Save as Snapshot...' in Ranorex Spy toolbar, select the desired location, enter a filename and click 'Save'.'Save as Snapshot...' button

  8. A progress dialog is shown during snapshot creation.
    Progress dialog is shown during snapshot creation

    Wait until the snapshot is created and successfully saved to the file.
     
    Snapshot has been created and saved

Screencast Watch the screencast How to create a snapshot file to see the procedure in action.

Snapshots of special UI elements

Particular UI elements of the SUT, such as drop-down menus, pop-up windows, combo boxes, etc., only become visible after a mouse click, or disappear if the SUT loses focus. These elements are often not automatically included in a Ranorex Snapshot , as they appear as separate items in Ranorex Spy at the top level of the element tree.

There are two ways to create Ranorex Snapshots of these elements:

Instant capturing with key shortcut Ctrl + Win

  1. Start your SUT.
  2. Start Ranorex Spy.
  3. Get to the part of your SUT you want to create a snapshot of.
  4. Place the mouse cursor above the part of the SUT you want to create a Ranorex Snapshot of and press key shortcut Ctrl + Win.
    This instantly tracks the element in Ranorex Spy.
  5. Save the Ranorex Snapshot as described above.

    Screencast Watch the screencast How to create a snapshot file of a context menu - Approach 1 to see this procedure in action.

Temporarily deactivate tracking with F12 key

  1. Start your SUT.
  2. Start Ranorex Spy.
  3. Get to the part of your SUT you want to create a snapshot of.
  4. In Ranorex Spy, press the TRACK-Button.
    Track button
    Now you are in tracking mode, which is indicated by a red border around the UI elements as you move the mouse cursor over them.
  5. Press and hold F12 key while navigating to the desired element in the SUT.
    While you press the F12 key, the tracking mode is paused.
  6. Move the mouse over the UI element of the SUT you want to track and release the F12 key.
  7. Wait until the red border appears and press the Scroll key.
    A temporary Ranorex Snapshot is created in Ranorex Spy. This may take a few seconds.
  8. Save the Ranorex Snapshot as described above.

    Screencast Watch the screencast How to create a snapshot file of a context menu - Approach 2 to see this procedure in action.