This function handles user interaction with marks.

Declaration:

AT_ERRCOUNT ART_GUI_interaction_process(
        HIGEAR hIGear,
        DWORD dwGrpID, 
        HWND hWnd,   
        UINT nMessage, 
        AT_MODE nMode, 
        LPAT_POINT lpPoint
);

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 */
UINT msg; /* Windows message  */
DWORD dwGrpID;
nUserMode = ART_MODE_RUN;
case WM_LBUTTONDOWN:
case WM_LBUTTONDBLCLK:
case WM_LBUTTONUP:
if (IG_image_is_valid(hIGear))
{
pt.x = LOWORD(lParam);
pt.y = HIWORD(lParam);
dwGrpID = IG_GRP_DEFAULT;
ART_GUI_interaction_process(hIGear, dwGrpID, hWnd, 
msg, nUserMode, &pt);
}
break;

Remarks:

This function is called in response to a Windows WM_LBUTTONDOWN, WM_LBUTTONUP, and WM_LBUTTONDBLCLK message. The nMode parameter is set to either the user-run mode or user-edit mode constants. lpPoint is the current position where the mouse button was pressed. The library handles creating, moving, re-sizing, selecting, and user run-mode interaction with marks.

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.