In This Topic ▼

ANNMOVEPOINT

Summary

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

Syntax

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

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 the LAnnXXX::AddUserHandle, LAnnXXX::DeleteUserHandle, LAnnXXX::ChangeUserHandle, or LAnnXXX::EnumerateHandles functions, where LAnnXXX represents the classes that support handles. These classes are as follows:

apt

Current location of point being moved, in container coordinates.

Comments

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.

Usage

ANNCHANGEPARAM