LVectorObject::GetTooltip

#include "ltwrappr.h"

L_UINT32 LVectorObject::GetTooltip(pBuffer, uSize)

L_TCHAR * pBuffer;

/* pointer to a buffer */

L_UINT32 uSize;

/* size of pBuffer */

Retrieves the tooltip of a vector object.

Parameter

Description

pBuffer

Pointer to a buffer to be updated with the specified object's tooltip.

uSize

Size of the buffer allocated for pBuffer.

Returns

If pBuffer is NULL, it will return the size of the buffer required for the tooltip 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::SetTooltip, LVectorObject::ShowTooltip, LVectorObject::HideTooltip

Topics:

Vector Images: Tooltips

 

Working with the Tooltips

Example

L_INT LVectorObject__GetTooltipExample( LVectorObject *pVecObj, L_BOOL bShow ) 
{
   L_INT             nRet;
   L_UINT32          uSize;
   L_TCHAR*          pszTip;
   VECTORTOOLTIPDESC TooltipDesc; 
   nRet  = SUCCESS; 
   uSize = pVecObj->GetTooltip( NULL, 0 ); 
   pszTip = (L_TCHAR *)malloc( sizeof( L_TCHAR ) * uSize ); 
   if( NULL == pszTip ) 
      return ERROR_NO_MEMORY; 
   nRet = SUCCESS; 
   pVecObj->GetTooltip( pszTip, uSize ); 
   if( lstrcmp( pszTip, TEXT("test")) == 0 ) 
   {
      /* replace the tooltip */ 
      nRet = pVecObj->SetTooltip(TEXT("Final")); 
      if( SUCCESS == nRet ) 
      {
         if( bShow ) 
         {
            ZeroMemory( &TooltipDesc, sizeof( TooltipDesc ) ); 
            TooltipDesc.Point.x = 10; 
            TooltipDesc.Point.y = 10; 
            TooltipDesc.Pen.lopnColor = RGB( 0, 0, 0xFF ); 
            TooltipDesc.Pen.lopnWidth.x = 1; 
            TooltipDesc.Brush.lbColor = RGB( 0xED, 0xF3, 0xBB ); 
            lstrcpy( TooltipDesc.Font.lfFaceName, TEXT("Helvetica")); 
            TooltipDesc.Font.lfHeight = 5; 
            nRet = pVecObj->ShowTooltip( &TooltipDesc ); 
         }
         else
         {
            nRet = pVecObj->HideTooltip( ); 
         }
      }
   }
   free( pszTip ); 
   return nRet; 
}