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.

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

Win32, x64.

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

Help Version 19.0.2017.10.27

Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C API Help

Introduction

Version History

Getting Started

LEADTOOLS Raster Imaging Features

Redistributables/Files To Be Included With Your Application

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