ImageGear for C and C++ on Windows v19.1 - Updated
IG_GUI_page_active_set
API Reference Guide > Core Component API Reference > Core Component Functions Reference > GUI Functions > GUI Page Functions > IG_GUI_page_active_set

This function calls your selected callback function (of type LPFNIG_GUIPAGESELECTPROC) for the GUI Page Sorter window, as if the user had clicked on the page.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_GUI_page_active_set(
        HWND hwndPage, 
        UINT nPage
);

Arguments:

Name Type Description
hwndPage HWND HIGEAR Windows handle to the GUI Page Sorter window.
nPage UINT Set to the page number of the image in the GUI Page Sorter window that you would like to make "active."

Supported Raster Image Formats:

This function does not process image pixels.

Return Value:

Returns the number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.

Sample:

Page

Example:

Please see the example code under IG_GUI_page_active_get().

Remarks:

IG_GUI_page_active_set() is similar to IG_GUI_page_focus_set(), but goes one step further by calling the select callback function.