IG_GUI_pixdump_track

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

Declaration:

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

Arguments:

Name	Type	Description
hIGear	HIGEAR	HIGEAR handle of an image.
dwGrpID	DWORD	Identifier of a group that is used for drawing an image in the parent window.
hWndPixDump	HWND	Handle of a GUI pixdump window.
nX	INT	X position of the left mouse button click.
nY	INT	Y position of the 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:

All pixel formats supported by ImageGear for C and C++.

Sample:

GUI Windows, Display

Remarks:

See also the IG_GUI_pixdump_window_create() function.

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

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