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

Functions:

L_AnnSetAutoCursor, L_AnnSetUserData, L_AnnGetUserData, L_AnnSetAutoHilightPen, L_AnnSetOptions, L_AnnGetOptions, L_AnnSetAutoSnapCursor, L_AnnGetAutoSnapCursor

Topics:

Annotation Objects - Automated Features

 

Implementing an Automated Annotation Program

 

Annotation Functions (Document/Medical only): Automation Properties

 

Annotation Functions: Implementing Annotations

 

Annotation Functions: Displaying and Manipulating Annotation Objects

 

Annotation Features

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;
}