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

Declaration:

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:

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:

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:

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).