ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / Core Component API Reference / Core Component Functions Reference / GUI Functions / GUI Pixel Dump Functions / IG_GUI_pixdump_track_mouse
In This Topic
    IG_GUI_pixdump_track_mouse
    In This Topic

    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.

     

     

    ©2025 Accusoft Corporation. All Rights Reserved.

    Get Product Support