LVectorBase::SetOrigin

#include "ltwrappr.h"

virtual L_INT LVectorBase::SetOrigin(pOrigin=NULL)

const pVECTORPOINT pOrigin;

/* pointer to a vector point */

Sets the new origin for the class object's associated vector.

Parameter

Description

pOrigin

Pointer to a VECTORPOINT structure that contains the new origin. If this parameter is NULL, the new origin will be calculated based on the objects currently in the vector handle.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

The origin of a vector drawing may change whenever new objects are added. To insure that the drawing is centered around its origin, call LVectorBase::SetOrigin(NULL) after adding objects.

The origin may be retrieved using LVectorBase::GetOrigin.

LVectorBase::ApplyTransformation must be called to make the new origin take effect; if you dont your changes will not be saved.

Required DLLs and Libraries

LVKRN

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

LVectorBase::GetOrigin, LVectorBase::ApplyTransformation

Topics:

Working with Vector Handles

Example

This example moves the vector origin.

L_INT LVectorBase__SetOriginExample(HWND hWnd, LVectorBase *pVector)
{
   UNREFERENCED_PARAMETER(hWnd);
   L_INT       nRet;
   VECTORPOINT pointOrigin;
   nRet = pVector->GetOrigin (&pointOrigin);
   if(nRet != SUCCESS)
      return nRet;
   pointOrigin.x +=1;
   nRet = pVector->SetOrigin(&pointOrigin);
   if(nRet != SUCCESS)
      return nRet;
   return SUCCESS;
}