ImageGear for C and C++ on Windows v19.4 - Updated
ART_GUI_interaction_process
API Reference Guide > ART Component API Reference > ART Component Functions Reference > GUI Functions > ART_GUI_interaction_process

This function handles user interaction with marks.

Declaration:

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

Arguments:

Name Type Description
hIGear HIGEAR HIGEAR handle to the image.
dwGrpID DWORD Identifier of group.
hWnd HWND Windows handle to the image window.
nMessage UINT Windows message.
nMode AT_MODE An ART-defined constant of type AT_MODE that sets the image to run mode or edit mode.
lpPoint LPAT_POINT A far pointer to an ART-defined constant of type AT_POINT that gives the cursor position's screen coordinates.

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 */
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: