Host Class

Creates a new Host adapter instance. This constructor is used internally by the Ranorex Core Framework for performance issues!

Creates a new Host adapter instance.

Get available hosts.

Gets the immediate children of this adapter.

Gets the current host element. Use Ranore.Core.ElementEngine.Root to switch the current host. By default the current host is the local host.

Gets the name of the current active host (automation root)

The element associated with this adapter.

True if the element is enabled.

The name of the flavor this element belongs to.

True if the element has the focus.

Gets a value indicating whether this instance is a snapshot.

Gets the Form with the specified title, process name or process id.

Gets the local host element.

The network name of the machine Ranorex is running on.

The Windows edition of the machine running Ranorex.

The operating system version of the machine running Ranorex.

Gets the parent of this adapter.

The bit width architecture used by the current process.

The version of the Ranorex Framework in use.

True if the current user session is a remote session, i.e. operated via the remote desktop protocol.

Capabilities required by the adapter implementation.

The version of the .NET Runtime currently running Ranorex.

The bounding rectangle of the element in screen coordinates.

Gets or sets a value indicating whether EnsureVisible should be called before Click, DoubleClick, or MoveTo actions on this adapter instance.

The login name of the user who is running Ranorex.

Returns true if the element is believed to be valid.

The manufacturer of the virtual machine running the operating system.

True if the element is visible.

Activates the windows app with the specified app user model ID.

Activates the windows app with the specified app user model ID.

Activates the windows app with the specified app user model ID and arguments.

Activates the windows app with the specified app user model ID and arguments.

Returns an adapter of the specified type for the underlying element of the current adapter.

Captures a PNG image of the element.

Clears the cache of the specified browser.

Clears the cache of the specified browser.

Deletes all cookies from specified browser. Warning: Stored passwords or other important information will be deleted.

Deletes all cookies from specified browser. Warning: Stored passwords or other important information will be deleted.

Clicks on the adapter with the left mouse button.

Clicks on the adapter with the specified mouse buttons.

Clicks on the adapter with the left mouse button.

Clicks on the adapter at the specified location.

Clicks on the adapter with the left mouse button the specified number of times.

Clicks on the adapter with the specified mouse buttons.

Clicks on the adapter with the specified mouse buttons at a specific location location.

Clicks on the adapter at a specific location.

Clicks on the adapter with the specified mouse buttons at a given location.

Clicks on the adapter with the specified mouse buttons the specified number of times.

Clicks on the adapter at a specific location, with the left mouse button, the specified number of times.

Clicks at the specified location relative to the adapter with the specified mouse buttons the specified number of times.

Clicks on the adapter at the specified location, without reporting a warning if the location is outside the element.

Clicks on the adapter with the specified mouse buttons at a specific location location, without reporting a warning if the location is outside the element.

Clicks on the adapter at a specific location, without reporting a warning if the location is outside the element.

Clicks on the adapter with the specified mouse buttons at a given location, without reporting a warning if the location is outside the element.

Clicks on the adapter at a specific location, with the left mouse button, the specified number of times, without reporting a warning if the location is outside the element.

Clicks at the specified location relative to the adapter with the specified mouse buttons the specified number of times, without reporting a warning if the location is outside the element.

Closes an application with the specified process ID by trying to close its main window.

Closes an application or web page which contains the specified element.

Closes an application with the specified process ID by trying to close its main window.

Closes an application or web page which contains the specified element. If the application does not react to the close request within the specified grace period, the application process is killed.

Closes an application with a given process name.

Closes any open browser processes with the given name by sending a close message to its main window.

Deploys an iOS app archive to the specified device.

DoubleClicks on the adapter with the left mouse button.

DoubleClicks on the adapter with the specified mouse buttons.

DoubleClicks on the adapter with the left mouse button.

DoubleClicks on the adapter with the left mouse button at a specific location location.

DoubleClicks on the adapter with the specified mouse buttons.

DoubleClicks on the adapter with the specified mouse buttons at a specific location location.

DoubleClicks on the adapter at a specific location.

DoubleClicks on the adapter with the specified mouse buttons at a given location.

DoubleClicks on the adapter with the left mouse button at a specific location location, without reporting a warning if the location is outside the element.

DoubleClicks on the adapter with the specified mouse buttons at a specific location location, without reporting a warning if the location is outside the element.

DoubleClicks on the adapter at a specific location, without reporting a warning if the location is outside the element.

DoubleClicks on the adapter with the specified mouse buttons at a given location, without reporting a warning if the location is outside the element.

Performs a double tap action on the adapter.

Performs a double tap action on the adapter with the specified location.

Performs a double tap action on the adapter with the specified location.

Performs a double tap action on the adapter with the specified location.

Performs a double tap action on the adapter with the specified location, without reporting a warning if the location is outside the element.

Performs a double tap action on the adapter with the specified location, without reporting a warning if the location is outside the element.

Performs a double tap action on the adapter with the specified location, without reporting a warning if the location is outside the element.

Ensures that the element is visible to the user. This is usually accomplished by bringing the element or one of its ancestors to foreground.

Determines whether the specified object is equal to the current object.

Filters the given element list by the specified adapter type. The returned adapter list correspond to the elements that could be converted to the specified adapter type.

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

Applies a Ranorex Path to the adapter, returning instances of a specific adapter type (e.g. Role or Capability).

Applies a Ranorex Path to the adapter, returning instances of a specific adapter type (e.g. Role or Capability).

Finds an immediate child element of the given capability adapter type.

Finds an immediate child element of the given capability adapter type with a specific label.

Finds immediate child elements of the given capability adapter type.

Finds immediate child elements of the given capability adapter type with a specific label.

Finds a descendant of the given capability adapter type.

Finds a descendant of the given capability adapter type with a specific label.

Finds all descendants of the given capability adapter type.

Finds all descendants of the given capability adapter type with a specific label.

Applies a Ranorex Path to the adapter, returning an Element.

Applies a Ranorex Path to the adapter, returning an Element.

Tries to set the focus on the element.

Converts an Element to an instance of this class.

Converts a string to an instance of this class by searching the root.

Gets the main Form of a process.

Gets the main Form of a process.

Gets the main Form of a process.

Gets an attribute value using a generic return type.

Gets devtools session.

Serves as the default hash function.

Builds an absolute RxPath to the element, using the 'Default' path-build mode.

Builds an absolute RxPath to the element.

Gets the Type of the current instance.

Can be invoked to instrument/deploy an Android app to a configured device.

Can be invoked to instrument/deploy an Android app to a configured device.

Can be invoked to instrument/deploy an Android app to a configured device.

Instrument and deploy an iOS app.

Kills a process which the specified process ID.

Kills the process which contains the specified element.

Kills all applications with the specified process name.

Kills any open browser processes with the given name.

Performs a long touch action on the adapter.

Performs a long touch action on the adapter.

Performs a long touch action on the adapter with the specified location.

Performs a long touch action on the adapter with the specified location.

Performs a long touch action on the adapter with the specified location.

Performs a long touch action on the adapter with the specified location.

Performs a long touch action on the adapter with the specified location.

Performs a long touch action on the adapter with the specified location.

Performs a long touch action on the adapter with the specified location, without reporting a warning if the location is outside the element.

Performs a long touch action on the adapter with the specified location, without reporting a warning if the location is outside the element.

Performs a long touch action on the adapter with the specified location, without reporting a warning if the location is outside the element.

Performs a long touch action on the adapter with the specified location, without reporting a warning if the location is outside the element.

Performs a long touch action on the adapter with the specified location, without reporting a warning if the location is outside the element.

Performs a long touch action on the adapter with the specified location, without reporting a warning if the location is outside the element.

Activates the given host that will then be used as the new host.

Creates a shallow copy of the current Object.

Holds down on the adapter with the specified mouse buttons.

Releases on the adapter with the specified mouse buttons.

Moves the mouse to the adapter.

Moves the mouse to the adapter.

Moves the mouse to the specified location in the adapter.

Moves the mouse to the specified location in the adapter.

Moves the mouse to the specified location in the adapter, without reporting a warning if the location is outside the element.

Moves the mouse to the specified location in the adapter, without reporting a warning if the location is outside the element.

Opens a web page in the default browser.

Opens a web page in the specified browser.

Opens a web page in the specified browser.

Opens a web page in the specified browser.

Opens a web page in the specified browser.

Opens a web page in the specified browser.

Opens a web page in the specified browser.

Opens a web page in the specified browser.

Opens a web page in the specified browser.

Tries to set focus to the adapter and then presses the keys specified by sequence.

Tries to set focus to the adapter and then presses the keys specified by sequence.

Runs an application with the specified filename.

Runs an application with the specified filename, passing the specified arguments.

Runs an application with the specified filename, passing the specified arguments and setting the specified working directory.

Runs an application with the specified filename, passing the specified arguments and setting the specified working directory.

Runs an application with the specified filename, passing the specified arguments and setting the specified working directory.

Starts an app on a mobile device. This operation only works for devices that were configured trough the Ranorex user interface. This operation also works when the app is running on the device already. In that case the running app will be closed and started again to reset it into the initial state. Only apps that were instrumented by the Ranorex system can be started by Ranorex.

Starts an app on a mobile device. This operation only works for devices that were configured trough the Ranorex user interface. This operation also works when the app is running on the device already. In that case the running app will either be closed and started again to reset it into the initial state or only brought to the foreground depending on the 'resetInitialState' parameter. Only apps that were instrumented by the Ranorex system can be started by Ranorex.

Starts an app on a mobile device. This operation only works for devices that were configured trough the Ranorex user interface. This operation also works when the app is running on the device already. In that case the running app will either be closed and started again to reset it into the initial state or only brought to the foreground depending on the 'resetInitialState' parameter. Only apps that were instrumented by the Ranorex system can be started by Ranorex.

Performs a 'Swipe' operation that starts on the center point of the element with a specific direction.

Performs a 'Swipe' operations that starts at the point of the element specified by location.

Performs a 'Swipe' operations that starts at the point of the element specified by location, without reporting a warning if the location is outside the element.

Returns a String that represents the current Object.

Performs a touch action on the adapter.

Performs a touch action on the adapter.

Performs a touch action on the adapter.

Performs a touch action on the adapter with the specified location.

Performs a touch action on the adapter with the specified location.

Performs a touch action on the adapter.

Performs a touch action on the adapter with the specified location.

Performs a touch action on the adapter.

Performs a touch action on the adapter with the specified location.

Finishes a multi touch operation on the adapter.

Finishes a multi touch operation on the adapter.

Finishes a multi touch operation on the adapter.

Finishes a multi touch operation on the adapter.

Finishes a multi touch operation on the adapter.

Finishes a multi touch operation on the adapter.

Finishes a multi touch operation on the adapter, without reporting a warning if the location is outside the element.

Finishes a multi touch operation on the adapter, without reporting a warning if the location is outside the element.

Finishes a multi touch operation on the adapter, without reporting a warning if the location is outside the element.

Finishes a multi touch operation on the adapter, without reporting a warning if the location is outside the element.

Finishes a multi touch operation on the adapter, without reporting a warning if the location is outside the element.

Finishes a multi touch operation on the adapter, without reporting a warning if the location is outside the element.

Performs a touch move action on the adapter. This adds a move to the specified location with finger/mouse pressed.

Performs a touch move action on the adapter. This adds a move to the specified location with finger/mouse pressed.

Performs a touch move action on the adapter. This adds a move to the specified location with finger/mouse pressed.

Performs a touch move action on the adapter. This adds a move to the specified location with finger/mouse pressed.

Performs a touch move action on the adapter. This adds a move to the specified location with finger/mouse pressed.

Performs a touch move action on the adapter. This adds a move to the specified location with finger/mouse pressed.

Performs a touch move action on the adapter. This adds a move to the specified location with finger/mouse pressed.

Performs a touch move action on the adapter. This adds a move to the specified location with finger/mouse pressed.

Performs a touch move action on the adapter, without reporting a warning if the location is outside the element. This adds a move to the specified location with finger/mouse pressed.

Performs a touch move action on the adapter, without reporting a warning if the location is outside the element. This adds a move to the specified location with finger/mouse pressed.

Performs a touch move action on the adapter, without reporting a warning if the location is outside the element. This adds a move to the specified location with finger/mouse pressed.

Performs a touch move action on the adapter, without reporting a warning if the location is outside the element. This adds a move to the specified location with finger/mouse pressed.

Performs a touch move action on the adapter, without reporting a warning if the location is outside the element. This adds a move to the specified location with finger/mouse pressed.

Performs a touch move action on the adapter, without reporting a warning if the location is outside the element. This adds a move to the specified location with finger/mouse pressed.

Performs a touch move action on the adapter, without reporting a warning if the location is outside the element. This adds a move to the specified location with finger/mouse pressed.

Performs a touch move action on the adapter, without reporting a warning if the location is outside the element. This adds a move to the specified location with finger/mouse pressed.

Performs a touch start action on the adapter.

Begins a multi touch operation on the adapter. Multi touch operations can be used to compose more complex touch gestures. E.g. a swipe from left to right could be composed in the following way: Useful multitouch operations always have the form

• 1 TouchStart
• 0-N TouchMove
• 1 TouchEnd

Performs a touch start action on the adapter.

Begins a multi touch operation on the adapter. Multi touch operations can be used to compose more complex touch gestures. E.g. a swipe from left to right could be composed in the following way: Useful multitouch operations always have the form

• 1 TouchStart
• 0-N TouchMove
• 1 TouchEnd

Performs a touch start action on the adapter, without reporting a warning if the location is outside the element.

Begins a multi touch operation on the adapter, without reporting a warning if the location is outside the element. Multi touch operations can be used to compose more complex touch gestures. E.g. a swipe from left to right could be composed in the following way: Useful multitouch operations always have the form

• 1 TouchStart
• 0-N TouchMove
• 1 TouchEnd

Performs a touch start action on the adapter, without reporting a warning if the location is outside the element.

Begins a multi touch operation on the adapter, without reporting a warning if the location is outside the element. Multi touch operations can be used to compose more complex touch gestures. E.g. a swipe from left to right could be composed in the following way: Useful multitouch operations always have the form

• 1 TouchStart
• 0-N TouchMove
• 1 TouchEnd

Performs a touch action on the adapter, without reporting a warning if the location is outside the element.

Performs a touch action on the adapter with the specified location, without reporting a warning if the location is outside the element.

Performs a touch action on the adapter with the specified location, without reporting a warning if the location is outside the element.

Performs a touch action on the adapter, without reporting a warning if the location is outside the element.

Performs a touch action on the adapter with the specified location, without reporting a warning if the location is outside the element.

Performs a touch action on the adapter, without reporting a warning if the location is outside the element.

Performs a touch action on the adapter with the specified location, without reporting a warning if the location is outside the element.

Tries to apply a Ranorex Path to the adapter, returning an Element.

Tries to apply a Ranorex Path to the adapter, returning an Element.

Tries to apply a Ranorex Path to the adapter, returning a specific adapter type (e.g. Role or Capability).

Tries to apply a Ranorex Path to the adapter, returning a specific adapter type (e.g. Role or Capability).

Implicitly converts a string to an instance of this class by searching the root.

Implicitly converts an Element to an instance of this class.

Tries to convert the current host to a WebDriver endpoint.