L_AnnGetAutoCursor
#include "l_bitmap.h"
L_LTANN_API L_INT L_AnnGetAutoCursor(hAutomation uItem, phCursor)
|
HANNOBJECT hAutomation; |
/* handle to an automation object */ |
|
L_UINT uItem; |
/* value that specifies the cursor */ |
|
HCURSOR *phCursor; |
/* address of an HCURSOR variable */ |
Gets one of the cursors associated with automated annotations. This function is available in the Document/Medical Toolkits.
|
Parameter |
Description |
|
|
hAutomation |
Handle to the annotation automation object. |
|
|
uItem |
Value that specifies the cursor to be displayed on various actions. Possible values are: |
|
|
|
Value |
Meaning |
|
|
ANNAUTOCURSOR_DEFAULT |
[0] Displayed when cursor is over the annotation container, and other action is occurring. The default is the windows predefined cursor IDC_ARROW. |
|
|
ANNAUTOCURSOR_DRAWNEW |
[1] Displayed when drawing a new annotation (design mode). This is displayed on all tools except for ANNTOOL_SELECT (which displays the ANNAUTOCURSOR_DEFAULT). |
|
|
ANNAUTOCURSOR_HANDLE |
[2] Displayed in design mode, when cursor is over an annotation handle. |
|
|
ANNAUTOCURSOR_HOTSPOT |
[3] Displayed in run mode, when cursor over one of the following objects: |
|
|
|
ANNOBJECT_BUTTON |
|
|
|
ANNOBJECT_HOTSPOT |
|
|
|
ANNOBJECT_FREEHANDHOTSPOT |
|
|
|
ANNOBJECT_AUDIO |
|
|
|
ANNOBJECT_VIDEO |
|
|
|
ANNOBJECT_PUSHPIN |
|
|
ANNAUTOCURSOR_MOVE |
[4] Displayed in design mode, when an annotation is selected and the cursor is over the selected annotation (but not over the annotation handle). |
|
|
ANNAUTOCURSOR_SELECT |
[5] Displayed in design mode, when hovering over an unselected annotation. The default is the windows predefined cursor IDC_IBEAM. |
|
|
ANNAUTOCURSOR_TEXT |
[6] Displayed in design mode, when entering text into one of the following text annotations: |
|
|
|
ANNOBJECT_TEXT |
|
|
|
ANNOBJECT_TEXTPOINTER |
|
|
|
ANNOBJECT_RTF |
|
|
|
ANNOBJECT_NOTE |
|
|
The default is the windows predefined cursor IDC_IBEAM. |
|
|
|
ANNAUTOCURSOR_WAIT |
[7] Displayed during any wait operation. The default is the windows predefined cursor IDC_WAIT. |
|
|
ANNAUTOCURSOR_ROTATE_GRIPPER |
[8] Displayed when hovering over a gripper rotate handle. The rotate handles are displayed only after calling L_AnnSetOptions. |
|
|
ANNAUTOCURSOR_ROTATE_CENTER |
[9] Displayed when hovering over rotate center handle. The rotate handles are displayed only after calling L_AnnSetOptions (hAutomation, OPTIONS_NEW_ROTATE). |
|
|
The following cursors are displayed only after calling L_AnnSetOptions (hAutomation, OPTIONS_NEW_CURSORS). |
|
|
|
ANNAUTOCURSOR_SIZENS |
[10] Displayed when hovering over the north most or south most side select handles in a rectangular object. Note that the side select handles are only displayed after calling L_AnnSetOptions (hAutomation, OPTIONS_NEW_SIDE_HANDLES). |
|
|
ANNAUTOCURSOR_SIZENESW |
[11] Displayed when hovering over the North-east or South-west select handles in a rectangular object. |
|
|
ANNAUTOCURSOR_SIZEWE |
[12] Displayed when hovering over the west most or east most side select handles in a rectangular object. Note that the side select handles are only displayed after calling L_AnnSetOptions (hAutomation, OPTIONS_NEW_SIDE_HANDLES). |
|
|
ANNAUTOCURSOR_SIZENWSE |
[13] Displayed when hovering over the North-west or South-east select handles in a rectangular object. |
|
|
ANNAUTOCURSOR_SELECT_OUTLINE |
[14] Displayed when doing a drag type select in automation mode. |
|
|
The following cursors are displayed when the corresponding tool is active. For example, when the PolyLine tool is active in automation mode, the ANNAUTOCURSOR_TOOL_POLYLINE_CURSOR will be shown. |
|
|
|
ANNAUTOCURSOR_TOOL_LINE_CURSOR |
[15] Displayed when the line tool is active. |
|
|
ANNAUTOCURSOR_TOOL_RECT_CURSOR |
[16] Displayed when the rectangle tool is active. |
|
|
ANNAUTOCURSOR_TOOL_ELLIPSE_CURSOR |
[17] Displayed when the ellipse tool is active. |
|
|
ANNAUTOCURSOR_TOOL_POLYLINE_CURSOR |
[18] Displayed when the polyline tool is active. |
|
|
ANNAUTOCURSOR_TOOL_POLYGON_CURSOR |
[19] Displayed when the polygon tool is active. |
|
|
ANNAUTOCURSOR_TOOL_POINTER_CURSOR |
[20] Displayed when the pointer is active. |
|
|
ANNAUTOCURSOR_TOOL_FREEHAND_CURSOR |
[21] Displayed when the free hand is active. |
|
|
ANNAUTOCURSOR_TOOL_HILITE_CURSOR |
[22] Displayed when the highlight is active. |
|
|
ANNAUTOCURSOR_TOOL_REDACT_CURSOR |
[23] Displayed when the redact tool is active. |
|
|
ANNAUTOCURSOR_TOOL_TEXT_CURSOR |
[24] Displayed when the text tool is active. |
|
|
ANNAUTOCURSOR_TOOL_NOTE_CURSOR |
[25] Displayed when the note tool is active. |
|
|
ANNAUTOCURSOR_TOOL_STAMP_CURSOR |
[26] Displayed when the stamp tool is active. |
|
|
ANNAUTOCURSOR_TOOL_BUTTON_CURSOR |
[27] Displayed when the button tool is active. |
|
|
ANNAUTOCURSOR_TOOL_HOTSPOT_CURSOR |
[28] Displayed when the hotspot tool is active. |
|
|
ANNAUTOCURSOR_TOOL_AUDIO_CURSOR |
[29] Displayed when the audio tool is active. |
|
|
ANNAUTOCURSOR_TOOL_RULER_CURSOR |
[30] Displayed when the ruler tool is active. |
|
|
ANNAUTOCURSOR_TOOL_CROSSPRODUCT_CURSOR |
[31] Displayed when the cross product tool is active. |
|
|
ANNAUTOCURSOR_TOOL_POINT_CURSOR |
[32] Displayed when the point tool is active. |
|
|
ANNAUTOCURSOR_TOOL_PROTRACTOR_CURSOR |
[33] Displayed when the protractor tool is active. |
|
|
ANNAUTOCURSOR_TOOL_VIDEO_CURSOR |
[34] Displayed when the video tool is active. |
|
|
ANNAUTOCURSOR_TOOL_PUSHPIN_CURSOR |
[35] Displayed when the pushpin tool is active. |
|
|
ANNAUTOCURSOR_TOOL_FREEHANDHOTSPOT_CURSOR |
[36] Displayed when the freehand hotspot tool is active. |
|
|
ANNAUTOCURSOR_TOOL_CURVE_CURSOR |
[37] Displayed when the curve tool is active. |
|
|
ANNAUTOCURSOR_TOOL_CURVECLOSED_CURSOR |
[38] Displayed when the closed curve tool is active. |
|
|
ANNAUTOCURSOR_TOOL_ENCRYPT_CURSOR |
[39] Displayed when the encrypt tool is active. |
|
|
ANNAUTOCURSOR_TOOL_TEXTPOINTER_CURSOR |
[40] Displayed when the text pointer tool is active. |
|
|
ANNAUTOCURSOR_TOOL_POLYRULER_CURSOR |
[41] Displayed when the polyruler tool is active. |
|
|
ANNAUTOCURSOR_TOOL_RTF_CURSOR |
[42] Displayed when the RTF tool is active. |
|
|
ANNAUTOCURSOR_TOOL_RUBBERSTAMP_CURSOR |
[43] Displayed when the rubber stamp tool is active. |
|
phCursor |
Address of an HCURSOR variable to be updated with the requested annotation cursor. |
|
Returns
|
SUCCESS |
The function was successful. |
|
< 1 |
An error occurred. Refer to Return Codes. |
Comments
Call this function to retrieve a copy of one of the annotation cursors. It is the callers responsibility to call DestroyCursor() on the retrieved cursor when finished using the cursor. To customize the annotation cursors, call L_AnnSetAutoCursor.
Required DLLs and Libraries
|
LTANN For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application. |
Platforms
Windows 2000 / XP/Vista.
See Also
Example
This sample swaps the Default and Move annotation cursors.
L_INT AnnGetCursorsExample(HANNOBJECT hAutomation)
{
L_INT nRet;
HCURSOR hCursorMove, hCursorDefault;
// Get copy of original cursors
nRet = L_AnnGetAutoCursor(hAutomation, ANNAUTOCURSOR_DEFAULT, &hCursorDefault);
if(nRet != SUCCESS)
return nRet;
nRet = L_AnnGetAutoCursor(hAutomation, ANNAUTOCURSOR_MOVE, &hCursorMove);
if(nRet != SUCCESS)
return nRet;
// Change
nRet = L_AnnSetAutoCursor(hAutomation, ANNAUTOCURSOR_DEFAULT, hCursorMove);
if(nRet != SUCCESS)
return nRet;
nRet = L_AnnSetAutoCursor(hAutomation, ANNAUTOCURSOR_MOVE, hCursorDefault);
if(nRet != SUCCESS)
return nRet;
// Cleanup
DestroyCursor(hCursorMove);
DestroyCursor(hCursorDefault);
return SUCCESS;
}