LVectorObject::GetDescription

#include "ltwrappr.h"

L_UINT32 LVectorObject::GetDescription(pBuffer, uSize)

L_TCHAR * pBuffer;	/* pointer to a buffer */
L_UINT32 uSize;	/* size of pBuffer */

Retrieves the description string for the specified vector object.

Parameter	Description
pBuffer	Pointer to a buffer to be updated with the object description string.
uSize	Size of the buffer allocated for pBuffer.

Returns

If pBuffer is NULL, it will return the size of the buffer required for the description string. If pBuffer is not NULL, it will return the number of bytes actually written to the buffer.

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:	LVectorObject::SetDescription
Topics:	Vector Images: Obtaining Object Information
	Working with Vector Objects

Example

L_INT ModifyDescription( LVectorObject *pVecObj )
{
   L_INT  nRet;
   L_UINT32  uSize;
   L_TCHAR    *pszDesc;

   nRet  = SUCCESS;
   uSize = pVecObj->GetDescription( NULL, 0 );
   if( uSize > 0 )
   {
      pszDesc = (L_TCHAR *)malloc( sizeof( L_TCHAR ) * uSize );
      if( NULL == pszDesc )
      {
         return ERROR_NO_MEMORY;
      }

      pVecObj->GetDescription( pszDesc, sizeof( L_TCHAR ) * uSize );

      if( uSize > 4 )
      {
         pszDesc[ 0 ] = 'T';
         pszDesc[ 1 ] = 'E';
         pszDesc[ 2 ] = 'S';
         pszDesc[ 3 ] = 'T';

         nRet = pVecObj->SetDescription( pszDesc );
      }

      free( pszDesc );
   }
   return nRet;
}