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
L_VECTOR_WND 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.
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. |
Vector object that will be displayed when the hyperlinked vector object is clicked. Valid if bObject is TRUE.
VECTORLINKHANDLING value that indicates how the link activation will be handled. Valid if bObject is TRUE.
Information about the target that will be activated when the hyperlinked vector object is clicked. Valid if bObject is FALSE.
Handle to the parent window which will host the new application that will start when the hyperlinked vector object is clicked.
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: