VECTORLINKDESC

typedef struct _VECTORLINKDESC
{
   L_BOOL bObject; // TRUE means the link points to a vector object 

   union
   {
      struct
      {
         VECTOROBJECT target; // the target object if bObject is TRUE
         VECTORLINKHANDLING handling; // specifys how the toolkit will handle link activation
      }vectorobject;

      struct
      {
         VECTORLINKFILEINFO target; // information about the target file if bObject is FALSE
         HWND hwndParent; // Parent window if ( handling ) is VECTORLINKHANDLING_NEWWINDOW or if target is a file
      }fileobject;
   }tar;

}VECTORLINKDESC,  *pVECTORLINKDESC;

The VECTORLINKDESC structure is required to set the target type of a hyperlink object in the Vector toolkit.

Member

Description

bObject

Flag that indicates whether the Vector object will be displayed or information about the target will be activated when the hyperlinked vector object is clicked. Possible values are:

 

Value

Meaning

 

TRUE

A vector object will be displayed when the hyperlinked vector object is clicked. This vector object is contained in the target member of the vectorobject struct.

 

FALSE

Only information about the target will be displayed when the hyperlinked vector object is clicked. This information is contained in the VECTORLINKFILEINFO member of the fileobject struct.

target

Vector object that will be displayed when the hyperlinked vector object is clicked. Valid if bObject is TRUE.

handling

VECTORLINKHANDLING value that indicates how the link activation will be handled. Valid if bObject is TRUE.

target

Information about the target that will be activated when the hyperlinked vector object is clicked. Valid if bObject is FALSE.

hwndParent

Handle to the parent window which will host the new application that will start when the hyperlinked vector object is clicked.

Comments

pVECTORLINKDESC is a pointer to a VECTORLINKDESC structure. Where the function parameter type is pVECTORLINKDESC, you can declare a VECTORLINKDESC variable, update the structure's fields, and pass the variable's address in the parameter. Declaring a pVECTORLINKDESC variable is necessary only if your program requires a pointer.

The VECTORLINKDESC structure is used with the following functions:

L_VecAddHyperlink

L_VecGetHyperlink

L_VecSetHyperlink