ANNHANDLEINFO
typedef struct tagANNHANDLEINFO
{
L_UINT uStructSize;
L_INT nType;
L_INT nID;
L_INT nIndex;
ANNPOINT ptLocationContainer;
POINT ptLocationClient;
L_BOOL bVisible;
COLORREF crPen;
COLORREF crFill;
L_INT nShape;
HCURSOR hCursor;
L_INT nTotalHandles;
L_INT nReserved;
} ANNHANDLEINFO, *pANNHANDLEINFO;
This structure is used in the callback function with L_AnnEnumerateHandles.
Member |
Description |
|
uStructSize |
Size of this structure. Use sizeof(ANNHANDLEINFO) |
|
nType |
Type of handle. Possible values are: |
|
|
Value |
Meaning |
|
ANNHANDLETYPE_DEFAULT_HANDLE |
A default annotation handle. |
|
ANNHANDLETYPE_USER_HANDLE |
A user-defined annotation handle. |
|
ANNHANDLETYPE_ROTATE_HANDLE |
A rotate annotation handle. |
|
ANNHANDLETYPE_MULTISELECT_HANDLE |
A muti-select annotation handle (appears if more than one annotation object is selected). |
|
ANNHANDLETYPE_MULTISELECT_ROTATE_HANDLE |
A multi-select rotate handle (appears if more than one annotation object is selected). |
nID |
Unique identifier of the annotation handle. If ‘nType’ is ANNHANDLETYPE_ROTATE_HANDLE, then nID specifies if this is a center rotate handle (ROTATE_HANDLE_CENTER_ID) or a gripper rotate handle (ROTATE_HANDLE_GRIPPER_ID) |
|
nIndex |
This is the index of the user handle of the privately maintained array of user handles. Use nIndex with L_AnnChangeUserHandle or L_AnnDeleteUserHandle. This is only valid if the type of the handle is ANNHANDLETYPE_DEFAULT_HANDLE. |
|
ptLocationContainer |
The location of the handle in container coordinates. Container coordinates are typically the same dimensions of the underlying bitmap, and are independent of zooming and scrolling. |
|
ptLocationClient |
The location of the handle in client coordinates. Client coordinates factor in the current zoom factor, and the horizontal and vertical scrolling. |
bVisible |
Value that indicates whether the handle is visible. Possible values are: |
|
|
Value |
Meaning |
|
TRUE |
The handle is visible. |
|
FALSE |
The handle is invisible. |
crPen |
A COLORREF value that represents the color of the pen used to draw the user handle (the outline of the handle). |
|
crFill |
A COLORREF value that represents the color used to fill the user handle. |
nShape |
A value that indicates the shape of the handle. Possible values are: |
|
|
Value |
Meaning |
|
ANNHANDLE_SHAPE_SQUARE |
The shape of the user handle is square |
|
ANNHANDLE_SHAPE_CIRCLE |
The shape of the user handle is a circle |
hCursor |
Handle to a cursor. This is the cursor that appears when the mouse hovers over the user handle. If this value is zero, then a default cursor will appear. |
|
nTotalHandles |
The total number of annotation object handles. This includes both the default annotation handles and the user-defined annotation handles. |
|
nReserved |
Reserved for future use. Must set this field to zero. |