In This Topic ▼

LVectorObject::GetHyperlink

Summary

Gets information about one of the targets in the target list of a hyperlinked vector object.

Syntax

#include "ltwrappr.h"

L_INT LVectorObject::GetHyperlink(uIndex, pTarget)

Parameters

L_UINT32 uIndex

Index in the target list.

pVECTORLINKDESC pTarget

Pointer to a VECTORLINKDESC structure to be updated with the hyperlink target information.

Returns

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

Comments

This function returns an error if the object was not a hyperlinked vector object.

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

L_INT LVectorObject__GetHyperlinkExample( LVectorObject *pVecObj )  
{ 
   L_INT          nRet = SUCCESS; 
   L_UINT         i; 
   L_UINT         uCount; 
   VECTORLINKDESC Link; 
 
   uCount = pVecObj->GetHyperlinkCount( );  
   for( i = 0 ; i < uCount && SUCCESS == nRet ; i++ )  
   { 
      nRet = pVecObj->GetHyperlink( i, &Link ); 
      if(nRet != SUCCESS) 
         return nRet; 
 
      if(TRUE == Link.bObject && VECTOR_RECTANGLE == Link.tar.vectorobject.target.nType )  
      { 
         Link.bObject = FALSE;  
 
         lstrcpy( Link.tar.fileobject.target.szPath, MAKE_IMAGE_PATH(TEXT("cannon.jpg")));  
         Link.tar.fileobject.hwndParent = NULL;  
 
         nRet = pVecObj->SetHyperlink( i, &Link );  
         if(nRet != SUCCESS) 
            return nRet; 
      } 
      else 
         return FAILURE; 
   } 
 
   return SUCCESS; 
}