ImageGear for C and C++ on Windows v19.9 - Updated
LPFNIG_GUITHUMBSELECT
API Reference Guide > Core Component API Reference > Core Component Callback Functions Reference > LPFNIG_GUITHUMBSELECT

This function is called when the user selects a thumbnail in window hWndThumbnail.

Declaration:

 
Copy Code
typedef VOID (ACCUAPI LPFNIG_GUITHUMBSELECT) (
        LPVOID lpPrivate, 
        HWND hWndThumbnail, 
        const LPSTR lpszFileName, 
        const LPAT_DIB lpDIB, 
        UINT nPageNumber 
);

Arguments:

Name Type Description
lpPrivate LPVOID Far pointer to private data passed.
hWndThumbnail HWND Thumbnail window handle.
lpszFileName const LPSTR Far pointer to zero- terminated string, file name of thumbnail selected.
lpDIB const LPAT_DIB Far pointer to its DIB.
nPageNumber UINT Page number of the thumbnail that was selected from a GUI window. If the thumbnail comes from a non multi-page file, nPageNumber = 1.

Return Value:

None

Supported Raster Image Formats:

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

Sample:

Display, Thumbnail

Example:

For a complete example showing the use of this and other IG_GUI_Thumbnail functions and callbacks, see the Thumbnail sample application.

Remarks:

This type of callback function is registered by a call to IG_GUI_thumbnail_CB_register().

You are passed the filename and the address of a copy of the thumbnail image's DIB header. You are also passed the page number of the image in the file.