L_DocWriterAddPage

#include "l_bitmap.h"

L_LTDOCWRT_API L_INT EXT_FUNCTION L_DocWriterAddPage(hDocument, pPage)

DOCUMENTWRITER_HANDLE hDocument;	/* handle to an existing Document */
pDOCWRTPAGE pPage;	/* pointer to a DOCWRTPAGE page structure */

Adds a page to the document handle using information from the DOCWRTPAGE structure.

Parameter	Description
hDocument	Handle to an existing Document. This handle is obtained by calling the L_DocWriterInit function.
pPage	Pointer to a DOCWRTPAGE structure that contains information about the added page.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

Calls STATUSCALLBACK to follow the conversion process.

Before using the LEADTOOLS Document Writers SDK, unlock it using L_UnlockSupport. If you want to use the PDF format you must also unlock PDF support with L_UnlockSupport.

Required DLLs and Libraries

LtDocWrt_u.dll, LtDocWrt_x.dll
LtFil_u.dll, LtFil_x.dll
LfJb2_u.dll, LfJb2_x.dll
Lfcmp_u.dll, Lfcmp_x.dll
Lftif_u.dll, Lftif_x.dll
Lfraw_u.dll, Lfraw_x.dll
Lfbmp_u.dll, Lfbmp_x.dll
Lfpng_u.dll, Lfpng_x.dll
For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Windows 2000 / XP / Vista.

See Also

Functions:	L_DocWriterInit, L_DocWriterFinish
Topics:	Creating Document Formats
	Raster Image Functions: Document Writers

Example

This example creates a PDF file

L_LTDOCWRTTEX_API L_INT L_DocWriterAddPageExample(L_VOID)
{
   DOCWRTPDFOPTIONS pdf;
   L_INT nRet=0;
   L_DOUBLE dTextScale = 0.5;
   DOCUMENTWRITER_HANDLE hDocument;
   DOCWRTPAGE Page;
   BITMAPHANDLE OverlayBitmap;

   pdf.bImageOverText = TRUE;
   pdf.FontEmbed = DOCWRTFONTEMBED_ALL;
   pdf.PdfProfile = DOCWRTPDFPROFILE_PDF;
   pdf.bLinearized = FALSE;
   pdf.pwszTitle = TEXT("Add your title here");
   pdf.pwszSubject = TEXT("Add your subject here");
   pdf.pwszKeywords = TEXT("Add your keywords here");
   pdf.pwszAuthor = TEXT("Add author name here");
   pdf.bProtected = TRUE;
   pdf.pszUserPassword = "User password";
   pdf.pszOwnerPassword = "Owner password";
   pdf.EncryptionMode = (DOCWRTPDFENCRYPTIONMODE) DOCWRTPDFENCRYPTIONMODE_RC128BIT;
   pdf.bPrintEnabled = FALSE;
   pdf.bHighQualityPrintEnabled = TRUE;
   pdf.bCopyEnabled = FALSE;
   pdf.bEditEnabled = TRUE;
   pdf.bAnnotationsEnabled = TRUE;
   pdf.bAssemblyEnabled = FALSE;
   pdf.uFlags = 0;
   pdf.Options.uStructSize =  sizeof(pdf);
   // Use default resolution
   pdf.Options.nDocumentResolution = 0;
   pdf.Options.PageRestriction = (DOCWRTPAGERESTRICTION) DOCWRTPAGERESTRICTION_RELAXED;

   // Setup empty page size (Letter size)
   pdf.Options.dEmptyPageWidth = 8.5;
   pdf.Options.dEmptyPageHeight = 11;
   pdf.Options.nEmptyPageResolution = 300;
   pdf.Options.bMaintainAspectRatio = FALSE;

   nRet = L_DocWriterInit( &hDocument, 
                           TEXT("%UserProfile%\\My Documents\\LEADTOOLS Images\\Output.pdf"), 
                           DOCUMENTFORMAT_PDF, 
                           &pdf, 
                           NULL, 
                           NULL );
   if(nRet != SUCCESS)
      return nRet;

   nRet = L_LoadBitmap (TEXT("%UserProfile%\\My Documents\\LEADTOOLS Images\\Image1.emf"), 
                        &OverlayBitmap, sizeof(BITMAPHANDLE), 
                        0, 
                        ORDER_BGR, 
                        NULL, 
                        NULL);
   if(nRet != SUCCESS)
      return nRet;

   Page.uStructSize = sizeof(Page);
   Page.hEmf = GetEnhMetaFile(TEXT("%UserProfile%\\My Documents\\LEADTOOLS Images\\Image1.emf"));
   Page.pdwTextScale = &dTextScale;
   Page.pOverlayBitmap = &OverlayBitmap;

   nRet = L_DocWriterAddPage( hDocument, &Page );
   if(nRet != SUCCESS)
      return nRet;

   nRet = L_DocWriterFinish( hDocument );
   if(nRet != SUCCESS)
      return nRet;

   if(OverlayBitmap.Flags.Allocated)
      L_FreeBitmap(&OverlayBitmap);

   return SUCCESS;
}