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

    This function is called to create a GUI magnify window.

    Declaration:

     
    Copy Code
    AT_ERRCOUNT ACCUAPI IG_GUI_magnify_window_create (
            HIGEAR hIGear, 
            DWORD dwGrpID, 
            HWND hWndParent, 
            const LPSTR lpszTitle, 
            INT nX, 
            INT nY, 
            INT nWidth, 
            INT nHeight, 
            HWND FAR* lphWndMagnify
    );
    

    Arguments:

    Name Type Description
    hIGear HIGEAR HIGEAR handle of image.
    DwGrpID DWORD Identifier of the group used for drawing image in the hWndParent window. A new group will be allocated internally for drawing image in the magnify window.
    hWndParent HWND Handle of Parent window.
    lpszTitle const LPSTR Title of Magnify Window.
    nX INT X position of upper left corner of Magnify window.
    nY INT Y position of upper left corner of Magnify window.
    nWidth INT Width of Magnify window.
    nHeight INT Height of Magnify window.
    lphWndMagnify HWND FAR* Far pointer to HWND object to hold Magnify window handle.

    Return Value:

    Returns the number of ImageGear errors that occurred during this function call.

    Supported Raster Image Formats:

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

    Sample:

    Magnify, Display, GUI Windows

    Example:

    See the example for function IG_GUI_magnify_track_mouse().

    Remarks:

    When the mouse is moved about in such a window with the left button held down, a small rectangle is dragged and the portion of the image inside the rectangle can be displayed (magnified) in the parent image window.

    See the IG_GUI_magnify_track_mouse() function.