This function returns the value of a page array with index nPage.
Declaration:
 Copy Code |
|
|---|---|
AT_ERRCOUNT ACCUAPI IG_mpi_page_get(
[IN] HMIGEAR hMIGear,
[IN] UINT nPage,
[OUT] LPHIGEAR lpHIPage
);
|
|
Arguments:
| hMIGear | The handle to the allocated multi-page image. |
| nPage | The number of the page to return. |
| lpHIPage | The far pointer indicating where to return a handle of the page. |
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:
All pixel formats supported by ImageGear Professional.
Sample:
MFC Multipage
Example:
| Copy Code |
|
|---|---|
HMIGEAR hMIGear; /* handle to multi-page image */ AT_ERRCOUNT nErrCount = IGE_SUCCESS; /* will hold returned error count */ UINT nPageCount = 0; /* number of pages that should get from multi-page image */ UINT I = 0; HIGEAR hIGear; /* handle of an image */ ... nErrCount = IG_mpi_page_get( hMIGear, i, &hIGear ); ... |
|
Remarks:
This value can be either NULL or a valid HIGEAR handle.
The multi-page image is not changed. This function makes a copy of the page handle.
This function does not load the page from an external file, but just returns the current page value of the multi-page image.
For multi-page vector documents, this function GETS a page from the underneath vector document data. The following formats are currently supported by this API: PDF, PostScript.