LVectorBase::AddLayer

Summary

Adds a new empty layer to a vector handle.

This function is available in the LEADTOOLS Vector Imaging Toolkit.

Syntax

virtual L_INT LVectorBase::AddLayer(pVectorLayer, dwFlags=VECTOR_FLAGS_RENAME_DUPLICATE_LAYERS);

Parameters

LVectorLayer * pVectorLayer

Pointer to an LVectorLayer object that specifies the layer settings.

L_UINT32 dwFlags

Flag that indicates whether or not to rename duplicate layer names. Possible values are:

Returns

Comments

To add a new vector layer, do the following:

1. Declare an LVectorLayer object.

2. Call LVectorLayer::GetLayerDesc to retrieve the current layer settings.

3. Change the layer settings.

4. Call LVectorLayer::SetLayerDesc to set the changed layer settings.

5. Pass the address of the LVectorLayer object to LVectorBase::AddLayer.

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

• LVectorLayer::DeleteLayer
• LVectorBase::GetLayerByName
• LVectorBase::GetLayerByIndex
• LVectorBase::CopyLayer
• LVectorLayer::EmptyLayer
• LVectorBase::SetActiveLayer
• LVectorBase::GetActiveLayer

Topics

• Working with Vector Layers

Example

This example will add a new layer to a vector handle.

L_INT LVectorBase__AddLayerExample(HWND hWnd, LVectorBase *pVector) 
{ 
   UNREFERENCED_PARAMETER(hWnd); 
 
   L_INT             nRet; 
   LVectorLayer      VectorLayer; 
   VECTORLAYERDESC   LayerDesc; 
 
   nRet = VectorLayer.GetLayerDesc(&LayerDesc); 
   if(nRet != SUCCESS) 
      return nRet; 
 
   lstrcpy(LayerDesc.szName, TEXT("Terry's New Layer")); 
 
   nRet = VectorLayer.SetLayerDesc(&LayerDesc); 
   if(nRet != SUCCESS) 
      return nRet; 
 
   nRet = pVector->AddLayer(&VectorLayer, VECTOR_FLAGS_RENAME_DUPLICATES); 
   if(nRet != SUCCESS) 
   { 
      MessageBox( NULL, TEXT("Could not add layer!"), TEXT(""), MB_OK ); 
 
      return nRet; 
   } 
 
   //...LVectorLayer destructor called when VectorLayer goes out of scope 
 
   return SUCCESS; 
}