RanorexRanorex Documentation
Location Class
NamespacesRanorexLocation
Represents an abstract, relative location within an element or on the screen.
Declaration Syntax
C#Visual BasicVisual C++
[SerializableAttribute]
public class Location
<SerializableAttribute> _
Public Class Location
[SerializableAttribute]
public ref class Location
Members
All MembersConstructorsMethodsProperties



IconMemberDescription
Location()()()
Initializes a new instance of the Location class. This is equivalent to using 'Location.Center'.

Location(Point)
Initializes a new instance of the Location class, using a pixel value.

Location(Int32, Int32)
Initializes a new instance of the Location class, using a pixel value.

Location(PointF)
Initializes a new instance of the Location class, using a proportional position.

Location(Double, Double)
Initializes a new instance of the Location class, using a proportional position.

Location(Bitmap)
Initializes a new instance of the Location class specifying an image to search for.

Location(Bitmap, Location)
Initializes a new instance of the Location class specifying an image to search for and a relative location inside the found image.

Location(Bitmap, Imaging..::.FindOptions)
Initializes a new instance of the Location class specifying an image to search for using the specified options.

Location(Bitmap, Location, Imaging..::.FindOptions)
Initializes a new instance of the Location class using an image to search for and a relative location inside the found image.

Center
Represents the center of an element.

CenterLeft
Represents the left center location of an element.

CenterRight
Represents the center right location of an element.

Clone()()()
Creates a new instance that is equal to this instance.

Equality(Location, Location)
Implements the operator ==.

Equals(Object)
Determines whether the specified Object is equal to the current Location.
(Overrides Object.Equals(Object).)
Feature
Gets or sets an image that should be searched inside an element.

FeatureOptions
Gets or sets the options for searching the Feature image.

Finalize()()()
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Inherited from Object.)
FixedLocation
Gets the relative pixel location if IsFixed is true. Throws an exception if the location is proportional.

GetElementLocation(Element, Boolean)
Gets the coordinates of a given Location corresponding to the specified element.

GetHashCode()()()
Serves as a hash function for a particular type.
(Overrides Object.GetHashCode()()().)
GetScreenLocation(Element)
Gets the screen coordinates of a given Location corresponding to the specified element.

GetType()()()
Gets the type of the current instance.
(Inherited from Object.)
Implicit(Point)
Performs an implicit conversion from Point to Location.

Implicit(PointF)
Performs an implicit conversion from PointF to Location.

Implicit(String)
Performs an implicit conversion from String to Location.

Implicit(Bitmap)
Performs an implicit conversion from Bitmap to Location.

Inequality(Location, Location)
Implements the operator !=.

IsFixed
Gets a value indicating whether this instance is fixed, i.e. has a fixed pixel value.

IsImageBased
Gets a value indicating whether this instance searches for a Feature image inside an element to get a relative offset inside the element.

IsProportional
Gets a value indicating whether this instance is proportional, i.e. is proportional to the width and height of the element.

LowerCenter
Represents the lower center location of an element.

LowerLeft
Represents the lower left corner of an element.

LowerRight
Represents the lower right corner of an element.

MemberwiseClone()()()
Creates a shallow copy of the current Object.
(Inherited from Object.)
Parse(String)
Creates a new instance of the Location class from its string representation.

ProportionalLocation
Gets the proportional location if IsFixed is false. Throws an exception if the location is fixed.

StandardValues
Gets an array of the standard locations.

ToString()()()
Returns a String that represents the current Location.
(Overrides Object.ToString()()().)
TryParse(String, Location%)
Tries to creates a new instance of the Location class from its string representation.

UpperCenter
Represents the upper center location of an element.

UpperLeft
Represents the upper left corner of an element.

UpperRight
Represents the upper right corner of an element.

Remarks
A location is a relative offset inside an element. It can either be specified by a fixed pixel value (x,y), a percentage of an element's height or width (e.g. Center, UpperRight), or an image that should be found inside the element.
Inheritance Hierarchy
Object
Location

Assembly: Ranorex.Core (Module: Ranorex.Core) Version: 4.0.3.22982 (4.0.3.22982)