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 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.