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