ImageGear Professional DLL v17.1 for Windows Accusoft
LPFNIG_GUITHUMBCOMP
Send Feedback  
ImageGear Professional DLL v17.1 for Windows > API Reference Guide > Core Component API Reference > Core Component Callback Functions Reference > LPFNIG_GUITHUMBCOMP

Glossary Item Box

This function is called automatically for successive pairs of thumbnails in your thumbnail window, until all have been sorted.

Declaration:

  Copy Code
typedef INT (ACCUAPI LPFNIG_GUITHUMBCOMP) (
        LPVOID lpPrivate, 
        HWND hWndThumbnail, 
        const LPSTR lpszFileName1, 
        const LPSTR lpszFileName2, 
        const LPAT_DIB lpDIB1, 
        const LPAT_DIB lpDIB2 
);

Arguments:

lpPrivate Far pointer to private data passed.
hWndThumbnail Thumbnail window handle.
lpszFileName1 Far pointer to zero-terminated string; name of the first thumbnail file of two to be compared.
lpszFileName2 Far pointer to zero-terminated string; name of the second thumbnail file of two to be compared.
lpDIB1 Far pointer to DIB of first thumbnail file.
lpDIB2 Far pointer to DIB of second thumbnail file.

Return Value:

Return a value of -1, 0, or +1, to indicate the first thumbnail is to be before, equal, or after, the second thumbnail.

Supported Raster Image Formats:

All pixel formats supported by ImageGear Professional.

Sample:

Thumbnail

Example:

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

Remarks:

This type of callback function is registered during a call to IG_GUI_thumbnail_sort().

You are passed both the filename and the DIB pointer for each of the pair of thumbnails, and you may compare them in any way you wish. You return -1 to tell ImageGear that the first thumbnail (file and DIB1) should go "before" the other, or +1 to tell ImageGear that the first should go "after." Return 0 if either order is acceptable.

©2012. Accusoft Corporation. All Rights Reserved.