LVectorLayer::GetLayerDesc

#include "ltwrappr.h"

virtual L_INT LVectorLayer::GetLayerDesc(pLayerDesc=NULL)

/* pointer to a structure */

Gets layer information on the class object's associated layer.

Parameter	Description
pLayerDesc	Pointer to a VECTORLAYERDESC structure to be updated with the layer information if the layer is found.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

This function updates the m_Desc member variable of the LVectorLayer object.

This function can be used in conjunction with LVectorLayer::SetLayerDesc to change layer properties.

LVectorLayer::GetLayerDesc and LVectorLayer::SetLayerDesc should be called in pairs.

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::AddLayer, LVectorBase::GetLayerByIndex, LVectorBase::GetLayerByName, LVectorBase::GetLayerCount
Topics:	Working with Vector Layers

Example

// This example will add a new layer to a vector handle.
L_VOID Example68(HWND hWnd, LVectorBase *pVector)
{
   LVectorLayer VectorLayer;
   VECTORLAYERDESC LayerDesc;

   VectorLayer.GetLayerDesc(&LayerDesc);
   lstrcpy(LayerDesc.szName, TEXT("Terry's New Layer"));
   VectorLayer.SetLayerDesc(&LayerDesc);

   if (SUCCESS != pVector->AddLayer(&VectorLayer, VECTOR_FLAGS_RENAME_DUPLICATES))
   {
      MessageBox( NULL, TEXT("Could not add layer!"), TEXT(""), MB_OK );
   }

   //...LVectorLayer destructor called when VectorLayer goes out of scope
}