LVectorBase::Copy

#include "ltwrappr.h"

virtual L_INT LVectorBase::Copy(LVectorSrc, dwFlags=0)

LVectorBase& LVectorSrc;

/* the source vector object to be copied */

L_UINT32 dwFlags;

/* copy flags */

Copies a vector.

Parameter

Description

LVectorSrc

The source vector to be copied.

dwFlags

Flag that indicate the characteristics of the copy process. Possible values are:

 

Value

Meaning

 

0

Copy the entire vector handle from the source vector to the destination vector.

 

VECTOR_FLAGS_SELECTED_ONLY

Copy only selected objects from the source vector to the destination vector.

 

VECTOR_FLAGS_REPLACE

Empty the destination vector handle before copying.

 

VECTOR_FLAGS_RENAME_DUPLICATES

Renames duplicate layer names if found. This flag is only valid when VECTOR_FLAGS_REPLACE is not specified. The toolkit will add a suffix (0, 1, 2, etc) to the layer name if duplicated. Checking will be aborted when the suffix value reaches 999 and no unique name can be created.

 

VECTOR_FLAGS_COPY_INTO_ACTIVE_LAYER

Copies objects and layers into the active layer of the destination vector.

 

VECTOR_FLAGS_COPY_LAYERS_ONLY

Copies all layers and objects from the source vector to the destination vector. Transformation, camera, viewport and all other properties of the destination vector will not be effected.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

Call this function to copy a vector. This will copy the vector handle and data, all the other settings will not be changed.

Note: The LVectorSrc parameter is passed by reference, and is a required parameter.

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:

Class Members

Topics:

Vector Images: Copying a Vector

Example

L_INT LVectorBase__CopyExample(HWND hWnd)
{
   UNREFERENCED_PARAMETER(hWnd);
   L_INT       nRet;
   LVectorBase MyVector, CopyVector;
   MyVector.SetFileName(TEXT("C:\\Program Files\\LEAD Technologies, Inc\\LEADTOOLS 15.0\\Images\\test.dxf"));
   nRet = MyVector.Load();
   if(nRet != SUCCESS)
      return nRet;
   nRet = CopyVector.Copy(MyVector);  //make a copy of the Vector
   if(nRet != SUCCESS)
      return nRet;
   //...
   return SUCCESS;
}