VECTOREVENT

typedef  struct  tagVECTOREVENT
{
     L_INT  nSize;
     L_UINT  uType;
     VECTOR_ENUM_STATUS  Status;
     L_INT  nErrorCode;
     pVECTOROBJECT  pObject;
     L_VOID  L_FAR  *pObjectDesc;
     pVECTORLAYER  pLayer;  
     pVECTORLAYERDESC  pLayerDesc;
     pVECTORGROUP  pGroup;
     pVECTORGROUPDESC  pGroupDesc;
     pVECTORPOINT  pPoint1;
     pVECTORPOINT  pPoint2;
   L_UINT32  dwFlags;
     L_VOID  L_FAR  *pUserData;
}  VECTOREVENT,  L_FAR  *  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_USELIGHTS

L_VecSetUseLights

Not used

Not used

Not used

Not used

Not used

Not used

Not used

Not used

bUseLights

VECTOR_EVENT_AMBIENTCOLOR

L_VecSetAmbientColor

Not used

Not used

Not used

Not used

Not used

Not used

Not used

Not used

Color

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.