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

This function is called to create a GUI pan window.

Declaration:

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

Arguments:

Name Type Description
hIGear HIGEAR HIGEAR handle of image.
dwGrpID DWORD Identifier of group which is used for drawing image in the hWndParent window. New group will be allocated internally for drawing image in the pan window.
hWndParent HWND Handle of Parent window.
hWndImage HWND Handle to the image window.
dwStyle DWORD Set to any Windows style bits that you would like the Pan window to have. This parameter can be a combination of window styles ORed together.
lpszTitle const LPSTR Title of Pan Window.
nX INT X position of upper left corner of window.
nY INT Y position of upper left corner of window.
nWidth INT Width of window.
nHeight INT Height of window.
lphWndPan HWND FAR* Far pointer to HWND object to hold Pan 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:

None

Example:

See the example for function IG_GUI_pan_track_mouse().

Remarks:

When the user moves the mouse around in the pan window, your application can pan the specified portion of the image, in the parent image window. See IG_GUI_pan_track_mouse().