ImageGear for C and C++ on Windows v19.3 - Updated
IG_GUI_color_profile_track_mouse
API Reference Guide > Core Component API Reference > Core Component Functions Reference > GUI Functions > GUI Color Profile Functions > IG_GUI_color_profile_track_mouse

This function can be called while processing the Windows mouse-button-down message WM_LBUTTONDOWN, for a Color Profile window's parent window.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_GUI_color_profile_track_mouse( 
        HIGEAR hIGear, 
        DWORD dwGrpID, 
        HWND hWndProfile, 
        INT nX, 
        INT nY 
);

Arguments:

Name Type Description
hIGear HIGEAR HIGEAR handle of image.
DwGrpID DWORD Display group identifier used for image drawing the options to be used in GUI calculations.
hWndProfile HWND Handle of GUI Profile window.
nX INT X position of left mouse button click.
nY INT Y position of left mouse button click.

Return Value:

Returns the number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.

Supported Raster Image Formats:

This function does not process image pixels.

Sample:

Display, GUI Windows

Remarks:

See the IG_GUI_color_profile_window_create() function.

You can obtain (nX, nY), the coordinates of the mouse click, from the parameters passed by Windows with the WM_... message. See the GUI Windows sample application for a description of how to use this and related IG_GUI_color_profile_...() functions.

You cannot use IG_GUI_..._track_mouse() functions with a WM_RBUTTONDOWN message. ImageGear only responds to left mouse button clicks.