ImageGear for C and C++ on Windows v19.5 - Updated
IG_GUI_magnify_window_create
API Reference Guide > Core Component API Reference > Core Component Functions Reference > GUI Functions > GUI Magnify Functions > IG_GUI_magnify_window_create

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.