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

This callback function gets called whenever the user presses the Delete key over a page icon from the page sorter window.

Declaration:

 
Copy Code
typedef VOID (ACCUAPI LPFNIG_GUIPAGEDELETEPROC)(
        LPVOID lpPrivate, 
        HWND hwndPage, 
        HIGEAR hIGear, 
        UINT nPageNumber, 
        BOOL fDestroy
);

Arguments:

Name Type Description
lpPrivate LPVOID A far pointer to private data that is being passed into the callback.
hwndPage HWND Windows handle to the page sorter window.
hIGear HIGEAR HIGEAR handle to the image.
nPageNumber UINT This integer variable is set to the page number of the image icon in the GUI page sorter that will be deleted.
fDestroy BOOL A variable of type BOOL that gives you the status of whether the page sorter window has been destroyed. TRUE = destroyed.

Return Value:

None

Supported Raster Image Formats:

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

Sample:

Page

Example:

 
Copy Code
HIGEAR hIGear;      /* HIGEAR handle of image   */
HWND hwndPage;  /* Windows handle to the Page Sorter window   */
LPFNIG_GUIPAGEDELETEPROC PageDeleteProc;  /* Callback to handle deletion*/
IG_GUI_page_delete_CB_register(hwndPage, PageDeleteProc, NULL);
/***************************************************************************/
/* Called when a page is deleted                                           */
/***************************************************************************/
VOID ACCUAPI PageDeleteProc(LPVOID lpPrivateData, HWND hwndPage, HIGEAR   hIGearPage, UINT
nPage, BOOL fDestroy)
{
   CHAR     szBuf[_MAX_PATH + 32];
   UINT     nPageCount;
   lpPrivateData;
   /* delete the image */
   IG_image_delete(hIGearPage);
}
/* See the Page.c sample code for a more complete procedure */

Remarks:

This callback must first be registered by calling IG_GUI_page_delete_CB_register().