ImageGear for C and C++ on Windows v19.1 - Updated
IG_GUI_thumbnail_window_create
API Reference Guide > Core Component API Reference > Core Component Functions Reference > GUI Functions > GUI Thumbnail Functions > IG_GUI_thumbnail_window_create

Please use new upgraded function IG_GUI_thumbnail_window_create_ex(). See Remarks, below.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_GUI_thumbnail_window_create (
        HWND hWndParent, 
        LPSTR lpszTitle, 
        INT nX, 
        INT nY, 
        INT nWidth, 
        INT nHeight, 
        HWND FAR* lphWndThumbnail 
);

Arguments:

Name Type Description
hWndParent HWND Handle of the Parent window.
lpszTitle LPSTR Title of the Thumbnail window.
nX INT X position of the window's upper left corner.
nY INT Y position of the window's upper left corner.
nWidth INT Width of the window.
nHeight INT Height of the window.
lphWndThumbnail HWND FAR* Far pointer to the HWND object to hold the Thumbnail window handle.

Return Value:

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

Supported Raster Image Formats:

This function does not process image pixels.

Sample:

Thumbnail, Display, FlashPix

Example:

For an example of this and other IG_GUI_thumbnail_ functions and callbacks, see sample application THUMB.

Remarks:

The functionality of this API call has been upgraded and supported by the new function IG_GUI_thumbnail_window_create_ex(). The reason that this new function has been created is that the old function does not allow you to set the Windows style of the thumbnail window. In the interest of backward compatibility, we have left the old function in its original form and have retained support for it. If you have already used the old function in your code, it is not mandatory that you modify your code, but it is recommended.

This function is called to create a GUI thumbnail window. A GUI thumbnail window allows your application to display thumbnails of images stored in image files. It also allows you to easily select and sort them.

See also the IG_GUI_thumbnail_attribute_get(), IG_GUI_thumbnail_attribute_set(), IG_GUI_thumbnail_file_append(), IG_GUI_thumbnail_dir_append(), and the other IG_GUI_thumbnail_...() functions.