ART_GUI_interaction

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;

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:

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.