ART_GUI_cursor

This function returns the type of cursor that is used when the mouse passes over marks or resizes handles.

Declaration:

	Copy Code
AT_ERRCOUNT ART_GUI_cursor_query( HIGEAR hIGear, DWORD dwGrpID, HWND hWnd, AT_MODE nMode, const LPAT_POINT lpPoint, HCURSOR FAR* lpCursor, LPAT_MODE lpCursorType );

Arguments:

Name	Type	Description
hIGear	HIGEAR	HIGEAR handle to the image.
dwGrpID	DWORD	Identifier of group.
hWnd	HWND	Windows handle to the image window.
nMode	AT_MODE	An ART-defined constant of type AT_MODE that indicates the current user mode: run mode or edit mode.
lpPoint	const LPAT_POINT	An ART-defined constant of type AT_POINT that gives the screen coordinates of the mouse position.
lpCursor	HCURSOR FAR*	A far pointer to a Window's cursor. ART will fill the memory that the HCURSOR pointer points to with a cursor of type HCURSOR.
lpCursorType	LPAT_MODE	A far pointer to an ART-defined constant of type AT_MODE that gives the suggested type of cursor to use.

Return Value:

Returns the number of ImageGear errors that occurred during the function call.

Supported Raster Image Formats:

All pixel formats supported by ImageGear for C and C++.

Sample:

Annotation

Example:

	Copy Code
HIGEAR hIGear; /* HIGEAR handle of image / AT_POINT pt; / Cursor position / HWND hwnd; / Windows handle to the / / window / AT_MODE nUserMode; / Run mode or edit mode / DWORD dwGrpID; nUserMode = ART_MODE_EDIT; . . . case WM_SETCURSOR: if (IG_image_is_valid(hIGear)) { GetCursorPos(&ptPos); ScreenToClient(hWnd, &ptPos); pt.x = ptPos.x, pt.y = ptPos.y; / Ask ART to provide the cursor */ dwGrpID = IG_GRP_DEFAULT; ART_GUI_cursor_query(hIGear, dwGrpID, hWnd, nUserMode, &pt, &hCursor, NULL); SetCursor(hCursor); return TRUE; }

Copy Code

HIGEAR hIGear; /* HIGEAR handle of image */
AT_POINT pt; /* Cursor position  */
HWND hwnd;  /* Windows handle to the   */
/* window    */
AT_MODE nUserMode; /* Run mode or edit mode */
DWORD dwGrpID;
nUserMode = ART_MODE_EDIT;
. . . 
case WM_SETCURSOR:
if (IG_image_is_valid(hIGear))
{
GetCursorPos(&ptPos);
ScreenToClient(hWnd, &ptPos);
pt.x = ptPos.x, pt.y = ptPos.y;
/* Ask ART to provide the cursor */
dwGrpID = IG_GRP_DEFAULT;
ART_GUI_cursor_query(hIGear, dwGrpID, 
hWnd, nUserMode, 
&pt, &hCursor, NULL);
SetCursor(hCursor);
return TRUE;
}

Remarks:

You can set nMode to a constant beginning with ART_MODE_ to find out what cursor is used in a particular mode (run or edit). The cursor type is chosen by ART. You then call the Windows function SetCursor() and use ART's cursor or a cursor of your own.

This function is called in response to a Windows WM_SETCURSOR message with nMode set to either the run or edit mode constant. lpPoint is the current position of the mouse cursor. lpCursor returns the cursor the library determined for use. If lpCursorType is not NULL, it is set with a constant identifier that indicates which one of the standard cursors is set in lpCursor. The application can choose to use its own cursor for the given lpCursorType. Do not delete the cursor returned in lpCursor with DeleteObject().

In the lpCursorType parameter, one of these values is returned:

ART_CURSOR_NESW	ART_CURSOR_ANY
ART_CURSOR_NS	ART_CURSOR_NOT_OVER_MARK
ART_CURSOR_NWSE	ART_CURSOR_SELECT
ART_CURSOR_EW	ART_CURSOR_MOVE
ART_CURSOR_WE	ART_CURSOR_OVER_MARK
ART_CURSOR_SENW	ART_CURSOR_CREATE_MARK
ART_CURSOR_SN	ART_CURSOR_WAIT
ART_CURSOR_SWNE

An error is set if any of the following conditions are met:

hIGear does not reference a valid ImageGear handle.
hWnd is not a valid window.
nMode is not a valid user mode constant.
lpPoint is not a valid address.
lpCursor is not a valid address (or NULL).
lpCursorType is not a valid address (or NULL).