In This Topic ▼

LVectorBase::GetLayerByName

Summary

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

Syntax

#include "ltwrappr.h"

virtual L_INT LVectorBase::GetLayerByName(pszName, pVectorLayer)

Parameters

const L_TCHAR *pszName

Character string that contains the name of the layer to get.

LVectorLayer * 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

Value	Meaning
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

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.

Example

This example will get a layer by name.

L_INT LVectorBase__GetLayerByNameExample(HWND hWnd, LVectorBase *pVector) 
{ 
   UNREFERENCED_PARAMETER(hWnd); 
 
   L_INT          nRet; 
   LVectorLayer   VectorLayer; 
   L_TCHAR        szMsg[100]; 
 
   //Get the layer called "Sphere3" 
   nRet = pVector->GetLayerByName(TEXT("Sphere3"), &VectorLayer); 
   if (nRet == SUCCESS) 
   { 
      VECTORLAYERDESC LayerDesc; 
      nRet = VectorLayer.GetLayerDesc(&LayerDesc); 
      if(nRet != SUCCESS) 
         return nRet; 
      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")); 
 
      return nRet; 
   } 
   MessageBox(NULL, szMsg, TEXT(""), MB_OK); 
 
   return SUCCESS; 
}