DOCWRTPAGE

typedef struct _DOCWRTPAGE
{
   L_UINT uStructSize;
   HENHMETAFILE hEmf;
   pBITMAPHANDLE pOverlayBitmap; //for Pdf file only
   L_DOUBLE *pdwTextScale; //For Pdf Image over text only
} DOCWRTPAGE, *pDOCWRTPAGE;

The DOCWRTPAGE structure provides information about the page being added to the document file.

Member

Description

uStructSize

Size of this structure in bytes, for versioning. Use the sizeof() to calculate this value.

hEmf

Handle to an EMF file being added.

pOverlayBitmap

Optional pointer to a Bitmap that will be used as an overlay bitmap (image over text).

pdwTextScale

Optional pointer to double values which set the scale value ratios for each word in the EMF file to the ones in the overlay image.

Comments

pDOCWRTPAGE is a pointer to DOCWRTPAGE structure. Generally, where a function parameter type is pDOCWRTPAGE, you can declare a DOCWRTPAGE variable, update the structure's fields, and pass the variable's address in the parameter. Declaring a pDOCWRTPAGE variable is necessary only if your program requires a pointer.

The pOverlayBitmap is an optional pointer and it should be used only when saving to Pdf file formats, all other formats will not consider this pointer. The pOverlayBitmap must be the raster image of the EMF file which is set to hEmf handle.

If the PageRestriction is relaxed,hEmf is not mandatory. If hEmf is null then an empty page will be created. For Pdf format, if hEmf and pOverlayBitmap contain valid data, a pdf document with raster image (the pOverlayBitmap) will be created.

The pdwTextScale is an optional pointer that has no meaning if pOverlayBitmap is not used. This pointer sets the scale values for each word in the EMF file to the ones in the overlay image. Providing correct scales will make selection words at resultant PDF file more accurate.

This structure is used with the L_DocWriterAddPage function.