typedef struct tagVECTOREVENT
{
L_INT nSize;
L_UINT uType;
VECTOR_EVENT_STATUS Status;
L_INT nErrorCode;
pVECTOROBJECT pObject;
L_VOID *pObjectDesc;
pVECTORLAYER pLayer;
pVECTORLAYERDESC pLayerDesc;
pVECTORGROUP pGroup;
pVECTORGROUPDESC pGroupDesc;
pVECTORPOINT pPoint1;
pVECTORPOINT pPoint2;
L_UINT32 dwFlags;
L_VOID *pUserData;
} VECTOREVENT, * pVECTOREVENT;
The VECTOREVENT structure holds information about an event.
Size of this structure. Used for versioning.
The type of event that was generated. For a list of possible values, refer to the Comments section below.
Status of the event. Possible values are:
Value | Meaning |
---|---|
VECTOR_EVENT_STATUS_BEFORE | The action that generated the event is about to be taken. |
VECTOR_EVENT_STATUS_AFTER | The action that generated the event was just completed. |
Error code associated with the event. For a list of possible values, refer to the Return Codes.
Pointer to the vector object associated with the event. This structure member is only valid for certain event types. For a list of the events for which this member is valid, refer to the table in the Comments section below.
Pointer to an object descriptor. This structure is only valid for certain event types. For a list of the events for which this member is valid, refer to the table in the Comments section below.
Pointer to the vector layer associated with the event. This structure member is only valid for certain event types. For a list of the events for which this member is valid, refer to the table in the Comments section below.
Pointer to a layer descriptor. This structure is only valid for certain event types. For a list of the events for which this member is valid, refer to the table in the Comments section below.
Pointer to the vector group associated with the event. This structure member is only valid for certain event types. For a list of the events for which this member is valid, refer to the table in the Comments section below.
Pointer to a group descriptor. This structure is only valid for certain event types. For a list of the events for which this member is valid, refer to the table in the Comments section below.
Pointer to a general point 1. This structure is only valid for certain event types. For a list of the events for which this member is valid, refer to the table in the Comments section below.
Pointer to a general point 2. This structure is only valid for certain event types. For a list of the events for which this member is valid, refer to the table in the Comments section below.
Flag that provides processing information. This member is only valid for certain event types. For a list of the events for which this member is valid, refer to the table in the Comments section below.
User defined data.
The uType member will correspond to the vector function called, for example if you call L_VecSetObject, an event of type VECTOR_EVENT_SETOBJECT will be fired.
The following table lists all the defined event types plus values for the structure variables, when defined. Not all structure members are defined for every event. For example, the Object pObject member is not defined for a VECTOR_EVENT_FREE event, but it is defined for the VECTOR_EVENT_TRANSLATION event. The pObject structure member is the same as the L_VecSetTranslation function.
Event (uType) | Function | pObject | pObjectDesc | pLayer | pLayerDesc | pGroup | pGroupDesc | pPoint1 | pPoint2 | dwFlags |
---|---|---|---|---|---|---|---|---|---|---|
VECTOR_EVENT_FREE | L_VecFree | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used |
VECTOR_EVENT_EMPTY | L_VecEmpty | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used |
VECTOR_EVENT_COPY | L_VecCopy | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used | dwFlags |
VECTOR_EVENT_VIEWPORT | L_VecSetViewport | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used |
VECTOR_EVENT_PAN | L_VecSetPan | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used |
VECTOR_EVENT_LOCKED | L_VecSetLocked | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used | bLocked |
VECTOR_EVENT_BACKGROUND | L_VecSetBackground | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Color |
VECTOR_EVENT_PALETTE | L_VecSetPalette | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used |
VECTOR_EVENT_VIEWMODE | L_VecSetViewMode | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used | nViewMode |
VECTOR_EVENT_TRANSLATION | L_VecSetTranslation | pObject | Not used | Not used | Not used | Not used | Not used | pTranslation | Not used | dwFlags |
VECTOR_EVENT_ROTATION | L_VecSetRotation | pObject | Not used | Not used | Not used | Not used | Not used | pRotation | pOrigin | dwFlags |
VECTOR_EVENT_SCALE | L_VecSetScale | pObject | Not used | Not used | Not used | Not used | Not used | pScale | pOrigin | dwFlags |
VECTOR_EVENT_ORIGIN | L_VecSetOrigin | Not used | Not used | Not used | Not used | Not used | Not used | pOrigin | Not used | Not used |
VECTOR_EVENT_APPLYTRANSFORMATION | L_VecApplyTransformation | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used |
VECTOR_EVENT_BINDVERTICESMODE | L_VecBindVertices | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used | nBindMode |
VECTOR_EVENT_PARALLELOGRAM | L_VecSetParallelogram | Not used | Not used | Not used | Not used | Not used | Not used | pMin | pMax | Not used |
VECTOR_EVENT_CAMERA | L_VecSetCamera | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used |
VECTOR_EVENT_METAFILE | L_VecConvertFromEMF | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used |
L_VecConvertFromWMF | ||||||||||
VECTOR_EVENT_ATTACHTOWINDOW | L_VecAttachToWindow | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used | dwFlags |
VECTOR_EVENT_MARKER | L_VecSetMarker | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used |
VECTOR_EVENT_HITTEST | L_VecSetHitTest | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used |
VECTOR_EVENT_POLYGONMODE | L_VecSetPolygonMode | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used | nPolygonMode |
VECTOR_EVENT_COPYFROMCLIPBOARD | L_VecCopyFromClipboard | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used | dwFlags |
VECTOR_EVENT_ADDLAYER | L_VecAddLayer | Not used | Not used | pLayer | pLayerDesc | Not used | Not used | Not used | Not used | dwFlags |
VECTOR_EVENT_DELETELAYER | L_VecDeleteLayer | Not used | Not used | pLayer | Not used | Not used | Not used | Not used | Not used | Not used |
VECTOR_EVENT_EMPTYLAYER | L_VecEmptyLayer | Not used | Not used | pLayer | Not used | Not used | Not used | Not used | Not used | Not used |
VECTOR_EVENT_COPYLAYER | L_VecCopyLayer | Not used | Not used | pLayerDst | Not used | Not used | Not used | Not used | Not used | dwFlags |
VECTOR_EVENT_SETLAYER | L_VecSetLayer | Not used | Not used | pLayer | pLayerDesc | Not used | Not used | Not used | Not used | Not used |
VECTOR_EVENT_SETACTIVELAYER | L_VecSetActiveLayer | Not used | Not used | pLayer | Not used | Not used | Not used | Not used | Not used | Not used |
VECTOR_EVENT_ADDGROUP | L_VecAddGroup | Not used | Not uesd | Not uesd | Not used | pGroup | pGroupDesc | Not used | Not used | dwFlags |
VECTOR_EVENT_DELETEGROUP | L_VecDeleteGroup | Not used | Not used | Not used | Not used | pGroup | Not used | Not used | Not used | Not uesd |
VECTOR_EVENT_DELETEGROUPCLONES | L_VecDeleteGroupClones | Not used | Not used | Not used | Not uesd | pGroup | Not uesd | Not used | Not used | dwFlags |
VECTOR_EVENT_EMPTYGROUP | L_VecEmptyGroup | Not uesd | Not uesd | Not used | Not used | pGroup | Not used | Not used | Not used | Not uesd |
VECTOR_EVENT_COPYGROUP | L_VecCopyGroup | Not uesd | Not used | Not used | Not used | pGroupDst | Not used | Not used | Not used | dwFlags |
VECTOR_EVENT_SETGROUP | L_VecSetGroup | Not used | Not used | Not used | Not used | pGroup | pGroupDesc | Not used | Not used | Not used |
VECTOR_EVENT_ADDOBJECT | L_VecAddObject | pObject | pObjectDesc | pLayer | Not used | Not used | Not used | Not used | Not used | Not used |
VECTOR_EVENT_DELETEOBJECT | L_VecDeleteObject | pObject | Not used | Not used | Not used | Not used | Not used | Not used | Not used | DwFlags |
VECTOR_EVENT_COPYOBJECT | L_VecCopyObject | pObjectDst | Not used | Not used | pLayerDst | Not used | Not used | Not used | Not used | Not used |
VECTOR_EVENT_SETOBJECT | L_VecSetObject | pObject | pObjectDesc | Not used | Not used | Not used | Not used | Not used | Not used | nType |
VECTOR_EVENT_EXPLODEOBJECT | L_VecExplodeObject | pObject | Not used | Not used | Not used | Not used | Not used | Not used | Not used | dwFlags |
VECTOR_EVENT_SELECTOBJECT | L_VecSelectObject | pObject | Not used | Not used | Not used | Not used | Not used | Not used | Not used | bSelect |
VECTOR_EVENT_OBJECTATTRIBUTES | L_VecSetObjectAttributes | pObject | Not used | Not used | Not used | Not used | Not used | Not used | Not used | dwFlags |
VECTOR_EVENT_LOADFILE | L_VecLoadFile | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used |
VECTOR_EVENT_ADDOBJECTTOGROUP | L_VecAddObjectToGroup | pObject | pObjectDesc | Not used | Not used | pGroup | Not used | Not used | Not used | Not used |
VECTOR_EVENT_CREATENEWWINDOW | L_VecGotoHyperlink | Not used | pObjectDesc | Not used | Not used | Not used | Not used | Not used | Not used | Not used |
VECTOR_EVENT_INVERTCOLORS | L_VecInvertColors | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used | Not used |
The events VECTOR_EVENT_USER to (VECTOR_EVENT_RESRVED-1) are user-defined. You can use any of these values when implementing your own events using L_VecEvent.
Note that when using Vector automation, dwFlags should be ORed with VECTOR_FLAGS_ADD_UNDO_NODE in order for the event to add an undo node.
pVECTOREVENT is a pointer to a VECTOREVENT structure.