DTWAIN_CreatePDFTextElement

Top  Previous  Next

The DTWAIN_CreatePDFTextElement creates a DTWAIN_PDFTEXTELEMENT that can be used for DTWAIN_AddPDFTextElement..

 

DTWAIN_PDFTEXTELEMENT DTWAIN_CreatePDFTextElement ( );

  

Return Values:

If the function succeeds, a new DTWAIN_PDFTEXTELEMENT is returned, otherwise NULL (0) is returned.

 

Comments:

The DTWAIN_CreatePDFTextElement function creates a new DTWAIN_PDFTEXTELEMENT that can be used in calls to DTWAIN_SetPDFTextElementString, DTWAIN_SetPDFTextElementFloat, DTWAIN_SetPDFTextElementLong, and DTWAIN_AddPDFTextElement.  To destroy a DTWAIN_PDFTEXTELEMENT, the DTWAIN_DestroyPDFTextElement is used.


The DTWAIN_PDFTEXTELEMENT can subsequentally have its values changed using DTWAIN_SetPDFTextElementLong, DTWAIN_SetPDFTextElementFloat, or DTWAIN_SetPDFTextElementString, depending on which value in the DTWAIN_PDFTEXTLEMENT that will be changed.


By default, the DTWAIN_PDFTEXTELEMENT will have the following characteristics:


  • Blank text
  • Text will be printed on all pages
  • Text position placement is at the (x,y) position of (0, 0) on the PDF page (bottom left corner of the non-rotated page).
  • Character and wordspacing is set to 0.0
  • Font is Helvetica
  • Font height is 12 points.
  • Color of text is RGB(0,0,0)  (Black)
  • Text rotation is 0 degrees (no rotation)
  • Text skewing is 0.0, 
  • X/Y scaling when rotating text is 0.0
  • Text transformation is done in the order of scaling, rotation, skewing.
  • Horizontal scaling is 100.0
  • Stroke width is 1
  • Render mode is 0 (fill text)