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.
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. |
The uType member will correspond to the vector function called, for example if you call LVectorBase::Empty, an event of type VECTOR_EVENT_EMPTY 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 member is not defined for a VECTOR_EVENT_FREE event, but it is defined for the VECTOR_EVENT_TRANSLATION event. The data contained in the Object structure member corresponds to the vector object that was translated. More information can be obtained by using the pObject as an argument to an LVectorObject constructor, or to a constructor of a derived class of LVectorObject (i.e. LVectorRectangle.)
The pVECTOROBJECT(pObject), pVECTORGROUP(pGroup), pVECTORLAYER(pLayer) pointers can all be passed to class library constructors to create class library objects. The LVectorObject (and derived classes of LVectorObject) has a constructor that takes a pVECTOROBJECT, the LVectorGroup has a constructor that takes a pVECTORGROUP, and the LVectorLayer class has a constructor that takes a pVECTORLAYER.
Event |
Function |
pObject |
pObjectDesc |
pLayer |
pLayerDesc |
pGroup |
pGroupDesc |
pPoint1 |
pPoint2 |
dwFlags |
VECTOR_EVENT_FREE |
LVectorBase::SetHandle |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
VECTOR_EVENT_EMPTY |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
|
VECTOR_EVENT_COPY |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
dwFlags |
|
VECTOR_EVENT_VIEWPORT |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
|
VECTOR_EVENT_PAN |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
|
VECTOR_EVENT_LOCKED |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
bLock |
|
VECTOR_EVENT_BACKGROUND |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Color |
|
VECTOR_EVENT_PALETTE |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
|
VECTOR_EVENT_VIEWMODE |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
nMode |
|
VECTOR_EVENT_TRANSLATION |
LVectorBase::SetTranslation |
The modified object(s). |
Not used |
Not used |
Not used |
Not used |
Not used |
pTranslation |
Not used |
dwFlags (where applicable) |
VECTOR_EVENT_ROTATION |
LVectorBase::SetRotation |
The modified object(s). |
Not used |
Not used |
Not used |
Not used |
Not used |
pRotation |
pOrigin |
dwFlags (where applicable) |
VECTOR_EVENT_SCALE |
LVectorBase::SetScale |
The modified object(s). |
Not used |
Not used |
Not used |
Not used |
Not used |
pScale |
pOrigin |
dwFlags (where applicable) |
VECTOR_EVENT_ORIGIN |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
pOrigin |
Not used |
Not used |
|
VECTOR_EVENT_APPLYTRANSFORMATION |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
|
VECTOR_EVENT_BINDVERTICESMODE |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
nMode |
|
VECTOR_EVENT_PARALLELOGRAM |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
pMin |
pMax |
Not used |
|
VECTOR_EVENT_CAMERA |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
|
VECTOR_EVENT_METAFILE |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
|
VECTOR_EVENT_ATTACHTOWINDOW |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
dwFlags |
|
VECTOR_EVENT_MARKER |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
|
VECTOR_EVENT_HITTEST |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
|
VECTOR_EVENT_POLYGONMODE |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
nMode |
|
VECTOR_EVENT_COPYFROMCLIPBOARD |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
dwFlags |
|
VECTOR_EVENT_ADDLAYER |
Not used |
Not used |
pLayer identifier of the LVectorBase object |
Not used |
Not used |
Not used |
Not used |
Not used |
dwFlags (where applicable) |
|
VECTOR_EVENT_DELETELAYER |
Not used |
Not used |
pLayer identifier of the LVectorBase object |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
|
VECTOR_EVENT_EMPTYLAYER |
Not used |
Not used |
pLayer identifier of the LVectorBase object |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
|
VECTOR_EVENT_COPYLAYER |
Not used |
Not used |
pLayer identifier of the LVectorBase object |
Not used |
Not used |
Not used |
Not used |
Not used |
dwFlags |
|
VECTOR_EVENT_SETLAYER |
Not used |
Not used |
pLayer identifier of the LVectorBase object |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
|
VECTOR_EVENT_SETACTIVELAYER |
Not used |
Not used |
pLayer identifier of the LVectorBase object |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
|
VECTOR_EVENT_ADDGROUP |
Not used |
Not used |
Not used |
Not used |
pGroup identifier of the LVectorBase object |
Not used |
Not used |
Not used |
dwFlags |
|
VECTOR_EVENT_DELETEGROUP |
Not used |
Not used |
Not used |
Not used |
pGroup identifier of the LVectorBase object |
Not used |
Not used |
Not used |
Not used |
|
VECTOR_EVENT_DELETEGROUPCLONES |
Not used |
Not used |
Not used |
Not used |
pGroup identifier of the LVectorBase object |
Not used |
Not used |
Not used |
dwFlags |
|
VECTOR_EVENT_EMPTYGROUP |
Not used |
Not used |
Not used |
Not used |
pGroup identifier of the LVectorBase object |
Not used |
Not used |
Not used |
Not used |
|
VECTOR_EVENT_COPYGROUP |
Not used |
Not used |
Not used |
Not used |
pGroup identifier of the LVectorBase object |
Not used |
Not used |
Not used |
dwFlags |
|
VECTOR_EVENT_SETGROUP |
Not used |
Not used |
Not used |
Not used |
pGroup identifier of the LVectorBase object |
Not used |
Not used |
Not used |
Not used |
|
VECTOR_EVENT_ADDOBJECT |
LVectorLayer::AddObject, LVectorBase::AddObject, LVectorDialog::DoModalVectorNewObject |
The modified object(s). |
Not used |
pLayer identifier of the LVectorBase object |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
VECTOR_EVENT_DELETEOBJECT |
The modified object(s). |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
dwFlags |
|
VECTOR_EVENT_COPYOBJECT |
The modified object(s). |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
|
VECTOR_EVENT_SETOBJECT |
LVectorObject::UnlockObject |
The modified object. |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
nType |
VECTOR_EVENT_EXPLODEOBJECT |
The modified object(s). |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
dwFlags |
|
VECTOR_EVENT_SELECTOBJECT |
The modified object(s). |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
bSelect |
|
VECTOR_EVENT_OBJECTATTRIBUTES |
LVectorObject::SetObjectAttributes |
The modified object(s). |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
dwFlags |
VECTOR_EVENT_LOADFILE |
LVectorBase::Load |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
VECTOR_EVENT_ADDOBJECTTOGROUP |
The modified object(s). |
Not used |
Not used |
Not used |
pGroup identifier of the LVectorBase object |
Not used |
Not used |
Not used |
Not used |
|
VECTOR_EVENT_CREATENEWWINDOW |
Not used |
pObjectDesc |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
|
VECTOR_EVENT_INVERTCOLORS |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |
Not used |