VECTOREVENT

typedef struct tagVECTOREVENT 
{ 
   L_INT nSize; 
   L_UINT uType; 
   [VECTOR_EVENT_STATUS](vector-event-status.md) 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.

Member	Description
nSize	Size of this structure. Used for versioning.
uType	The type of event that was generated. For a list of possible values, refer to the Comments section below.
Status	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.
nErrorCode	Error code associated with the event. For a list of possible values, refer to the Return Codes.
pObject	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.
pObjectDesc	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.
pLayer	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.
pLayerDesc	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.
pGroup	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.
pGroupDesc	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.
pPoint1	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.
pPoint2	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.
dwFlags	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.
pUserData	User defined data.

Comments

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 L_VecConvertFromWMF	Not used	Not used	Not used	Not used	Not used	Not used	Not used	Not used	Not used
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.

Help Version 19.0.2017.10.27