evCreate API 5.7 Help

GetPosition Function

Returns the 2D coordinates of a given reference point on the bounding box of a given object item in the 2D space of an Envision document currently opened in the Canvas Envision Creator app.

GetPosition( obj: [[[EvItem|canvas-envision-document-items.html#object-items]]], transformed?: boolean, refPoint?: [[[EvRefPoint|evrefpoint-enumeration.html]]] ): Promise<[[[EvCoord2D|evcoord2d-type-alias.html]]]>

Parameters

obj: EvItem

An Object item object, an object item from the Envision document currently opened in the Canvas Envision Creator app whose reference point location should be returned.

transformed?: boolean

A Boolean, a switch to indicate whether the given reference point is on the transformed (true) or original (false) bounding box of the given object item.

The default value is false.

refPoint?: EvRefPoint

A member of the EvRefPoint enumeration, a reference point on the bounding box of the given object item whose 2D coordinates in the document space should be returned.

The default value is the top left corner: "top_left".

Return value

Promise<EvCoord2D>

A Promise that, if fulfilled, resolves to an array of the X and Y coordinates of the given object item's reference point in the 2D document space.

27 March 2025