In This Topic ▼

ANNMOVEPOINT

typedef struct tagANNMOVEPOINT 
{ 
   L_UINT uStructSize; 
   L_INT nState; 
   POINT pt; 
   L_UINT uIndex; 
   ANNPOINT apt; 
} ANNMOVEPOINT, *pANNMOVEPOINT;

The ANNMOVEPOINT structure contains information about an annotation object when moving a point of the object in automated mode.

Members

uStructSize

Size of the ANNCHANGEPARAM structure. Use sizeof(ANNCHANGEPARAM).

nState

Value that indicates the state of the move. Possible values are:

Value	Meaning
STATE_BEGIN	[1]
STATE_UPDATE	[2]
STATE_END	[3]

pt

Current move location (in client coordinates)

uIndex

Index of the point (handle) being moved. The index can be used with other functions like L_AnnGetUserHandle, L_AnnChangeUserHandle, L_AnnDeleteUserHandle, and L_AnnEnumerateHandles.

apt

Current location of point being moved, in container coordinates.

Comments

The ANNMOVEPOINT structure is part of the union of the ANNCHANGEPARAM structure. For more information, see the documentation for ANNCHANGEPARAM.

A handle of an annotation object can be moved in automated mode by dragging the handle with the mouse. Doing so causes a WM_LTANNEVENT message to be sent where wParam is ANNCHANGE_ ANNCHANGE_MOVE_POINT and lParam points to a structure of type ANNCHANGEPARAM. In this case, the union of ANNCHANGEPARAM is type ANNMOVEPOINT. This message is sent when one of the following events occurs:

Starting the move point (with a mouse click): two messages are sent, one before and one after the initial mouse click. The nState field is set to STATE_BEGIN. The pt field contains the location of the mouse click, in client coordinates.
Moving the point of the object (by dragging the mouse): Pairs of messages (one before and one after) are sent for each mouse move. The nState field is set to STATE_UPDATE, and the pt field contains the location of the mouse.
Ending the move point (by releasing the mouse): One pair of messages is sent (one before and one after) for the mouse up. The nState field is set to STATE_END, and the pt field contains the location of the mouse when released.