Technical Reference > Graphics Builder Automation Interface > Object Drawing and Property Functions > AttributeBaseCoordinates

AttributeBaseCoordinates

Returns the base coordinates of an object. If you use these coordinates, also apply the transformation matrix. Refer to functions AttributeTransformationMatrixPut and AttributeTransformationMatrixGet.

This function applies to the selected object, which is typically the last placed object. By using the PageSelectFirstObject() and PageSelectNextObject() functions, you can access your objects and change or read their properties.

Syntax

AttributeBaseCoordinates(FromXPosition, FromYPosition, ToXPosition, ToYPosition)

FromXPosition:

Distance from the left hand side of the page to top left hand corner of the object, measured in pixels.

FromYPosition:

Distance from the top of the page to the top left hand corner of the object, measured in pixels.

ToXPosition:

Distance from the left hand side of the page to the bottom right hand corner of the object, measured in pixels.

ToYPosition:

Distance from the top of the page to the bottom right hand corner of the object, measured in pixels.

Return Value

The base coordinates of the current object. If values are out of range on writing to the attribute, the function will exit and report the error E_INVALIDARG. If there is no active object, they will exit with a return value of E_HANDLE.

Note: For details on handling return and error values, see Error Handling.

Related Functions

AttributeTransformationMatrixPut, AttributeTransformationMatrixGet