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

This function tells ImageGear which page should be highlighted and whether the scrollbars should be adjusted to make the page visible, if it is hidden.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_GUI_page_focus_set(
        HWND hwndPage, 
        UINT nPage, 
        BOOL fScrollToThumbnail
);

Arguments:

Name Type Description
hwndPage HWND HIGEAR Windows handle to the GUI Page Sorter.
nPage UINT Set to the page number of the image in the Page Sorter that you would like to update.
fScrollToThumbnail BOOL Set to TRUE if you would like the Page Sorter to scroll the window so that nPage is shown. Set to FALSE if you don't need the image specified by nPage to be shown in the window.

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.

Supported Raster Image Formats:

This function does not process image pixels.

Sample:

None

Example:

 
Copy Code
HIGEAR hIGear;   /* HIGEAR handle of image */
AT_ERRCOUNT nErrcount; /* Tally of ImageGear errors on the stack  */
HWND hwndPage; /* Windows handle to the Page Sorter window*/
nErrcount = IG_GUI_page_focus_set(hwndPage, 5, TRUE);