#include "ltdoc2.h"
L_LTDOC2_API L_INT EXT_FUNCTION L_Doc2UpdatePage(hDoc, pBitmap, nPageIndex)
L_HDOC2 hDoc; |
handle to the OCR document |
pBITMAPHANDLE pBitmap; |
pointer to the bitmap handle |
L_INT nPageIndex; |
page position |
Updates the current page with a new bitmap.
Parameter |
Description |
hDoc |
Handle to the OCR document. |
pBitmap |
Pointer to the bitmap handle that references the new page to be updated into the internal OCR list of pages. |
nPageIndex |
Index of the page to be updated. This is a zero-based index. |
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Use this function to update the content of a page after performing image processing on it.
For example, after a page is flipped using the L_FlipBitmap function, this function should then be called to update the OCR page.
Before using this function it is necessary to lock the page for updating by calling the L_Doc2LockPage function, and after the update is completed, and then unlock the page by calling the L_Doc2UnlockPage function.
Required DLLs and Libraries
LTDOC2 For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application. |
Functions: |
L_Doc2AddPage, L_Doc2GetPageCount, L_Doc2RemovePage, L_Doc2ExportPage, L_Doc2GetPageInfo, L_Doc2LockPage, L_Doc2UnlockPage, L_Doc2CleanupPages |
Topics: |
|
|
L_INT Doc2UpdatePageExample(L_HDOC2 hDoc, L_INT nPageIndex, pBITMAPHANDLE pBitmap)
{
L_INT nRet;
nRet = L_Doc2LockPage (hDoc, nPageIndex);
if(nRet != SUCCESS)
return nRet;
nRet = L_Doc2UpdatePage(hDoc, pBitmap, nPageIndex);
if (nRet != SUCCESS)
{
MessageBox(NULL, TEXT("An error occurred during L_Doc2UpdatePage."), TEXT("Error!"), MB_OK);
return nRet;
}
else
MessageBox(NULL, TEXT("The specified page is updated."), TEXT("Notice!"), MB_OK);
nRet = L_Doc2UnlockPage (hDoc, nPageIndex);
if(nRet != SUCCESS)
return nRet;
return SUCCESS;
}