LVectorBase::SetOrigin

Summary

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

Syntax

virtual L_INT LVectorBase::SetOrigin(pOrigin=NULL)

Parameters

const pVECTORPOINT 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

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 do not your changes will not be saved.

Required DLLs and Libraries

• LTVKRN
• 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; 
}