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:
Name |
Type |
Description |
lpPrivate |
LPVOID |
Far pointer to private data passed. |
hWndThumbnail |
HWND |
Thumbnail window handle. |
lpszFileName1 |
const LPSTR |
Far pointer to zero-terminated string; name of the first thumbnail file of two to be compared. |
lpszFileName2 |
const LPSTR |
Far pointer to zero-terminated string; name of the second thumbnail file of two to be compared. |
lpDIB1 |
const LPAT_DIB |
Far pointer to DIB of first thumbnail file. |
lpDIB2 |
const LPAT_DIB |
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 for C and C++.
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.