LVectorBase::GetLayerByName

#include "ltwrappr.h"

virtual L_INT LVectorBase::GetLayerByName(pszName, pVectorLayer)

const L_TCHAR L_FAR *pszName;	/* layer name */
LVectorLayer * pVectorLayer;	/* pointer to a vector layer object */

Gets the layer with the specified name, in the class object's associated vector handle.

Parameter	Description
pszName	Character string that contains the name of the layer to get.
pVectorLayer	Pointer to an LVectorLayer object structure to be updated with the layer handle, if the layer is found. If the layer is not found, this function will return ERROR_VECTOR_LAYER_NOT_FOUND.

Returns

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

Comments

If two or more layers in a vector handle have the same name, this function will get the first layer found.

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

Example

// This example will get a layer by name.
L_VOID Example69(HWND hWnd, LVectorBase *pVector)
{
   LVectorLayer VectorLayer;
   L_TCHAR szMsg[100];

   //Get the layer called "Sphere3"
   L_INT nRet = pVector->GetLayerByName(TEXT("Sphere3"), &VectorLayer);
   if (nRet == SUCCESS)
   {
      VECTORLAYERDESC LayerDesc;
      VectorLayer.GetLayerDesc(&LayerDesc);
      wsprintf(szMsg, TEXT("Layer Retrieved\nName[%s]\nSize[%d]\nLocked[%d]\nVisible[%d]"),
         LayerDesc.szName,
         LayerDesc.nSize,
         LayerDesc.bLocked,
         LayerDesc.bVisible
         );
   }
   else
   {
      wsprintf(szMsg, TEXT("Layer Not Found"));
   }
   MessageBox(NULL, szMsg, TEXT(""), MB_OK);
}