This function creates a page sorter window.
Declaration:
 Copy Code |
|
|---|---|
AT_ERRCOUNT ACCUAPI IG_GUI_page_window_create_ex (
HWND hwndParent,
DWORD dwGrpID,
DWORD dwStyle,
const LPSTR lpcszTitle,
INT x,
INT y,
INT nPageWidth,
INT nPageHeight,
HWND FAR *lphwndPage
);
|
|
Arguments:
| hWndParent | Windows handle to the parent window. |
| dwGrpID | Identifier of display group should be used for drawing thumbnail in the GUI page. |
| dwStyle | Set to any Windows style bits that you would like the Pan window to have. This parameter can be a combination of window styles ORed together. |
| lpcszTitle | A long pointer to a string that sets the title for the window. |
| x | A variable of type INT that sets the x position of the window. |
| y | A variable of type INT that sets the y position of the window. |
| nPageWidth | A variable of type INT that sets the width of the window. |
| nPageHeight | A variable of type INT that sets the height of the window. |
| lphwndPage | A long pointer that returns the window handle of the page sorter. |
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, hIGearSave /* HIGEAR handle of image */ AT_ERRCOUNT nErrcount; /* Tally of ImageGear errors */ INT xpos, ypos, /* Position of parent window */ INT nPageCount; /* # of pages in page sorter */ HWND hwndPage; /* Windows handle to a page */ nErrCount = IG_GUI_page_window_create_ex(hWnd, IG_GRP_DEFAULT, WS_CHILD|WS_VISIBLE, "Page Window", xpos, ypos, 320, 200, &hwndPage); /* save the pages in the sorter window to a multi-page file */ IG_GUI_page_count_get(hwndPage, &nPageCount); for (i = 1; i <= nPageCount; i++) { IG_GUI_page_handle_get(hwndPage, i, &hIGearSave); nErrCount = IG_save_file(hIGearSave, "NewPages.tif", IG_SAVE_FORMAT_TIF_RLE); if (nErrCount != 0) { /* report the error */ ErrorReport(hWnd); break; } } |
|
The Page Sorter Window as it is implemented in the sample application: Page.c. The parent window displays the currently selected image - 3.
Remarks:
The purpose of the page sorter window is to create a new multi-page file or to edit an existing one. When you're done editing the pages, you have the option to save out a single image file with multiple pages.
This function takes, as parameters, settings for the size and position of the page sorter, and returns you the handle of the new page sorter window. If there is no parent window, set hWndParent to NULL. The page sorter window will show small versions (thumbnails) of any file that is added to the page sorter window by the function IG_GUI_page_file_append(), or IG_GUI_page_insert().
- To move pages around (which effectively changes the numbering of the pages) hold down the Shift key while dragging with the left mouse button.
- To delete a page, select it with the mouse and click the Delete key.
- To modify the size of the page "thumbnails" or to read their current size, use IG_GUI_page_thumbnail_size_set() and IG_GUI_page_thumbnail_size_get() functions, respectively.
- To save the pages into one multi-page file, set up a loop that will "page" through each HIGEAR image and append it to a multi-page file with a call to IG_save_file(). This is demonstrated in the example code below.
 |
See also IG_GUI_page_update() and IG_GUI_page_document_update() functions. |