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 Professional.
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:
- 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.