DTWAIN_AddPDFTextElement
|
The DTWAIN_AddPDFTextElement adds text to a PDF page that is acquired using DTWAIN_AcquireFile or DTWAIN_AcquireFileEx. and the file type is either DTWAIN_PDF or DTWAIN_PDFMULTI. DTWAIN_BOOL DTWAIN_AddPDFTextElement (
Parameters Source Specifies a selected TWAIN Source.
TextElement A DTWAIN_PDFTEXTELEMENT that describes the text, font, etc.
Return Values: TRUE if successful, FALSE otherwise. If the function returns FALSE, call DTWAIN_GetLastError() to get extended information.
Comments: The DTWAIN_AddPDFTextElement function works the same as DTWAIN_AddPDFText except that the difference is that the DTWAIN_AddPDFTextElement text characteristics are retrieved from the passed-in TextElement, instead of specifying each characteristic as a separate parameter. Thus using DTWAIN_PDFTEXTELEMENT makes it easier to reuse and modify text characteristics, and have only the DTWAIN_PDFTEXTELEMENT passed as a parameter. To print multiple text items on a single page, you can add multiple unique TextElement items to the Source. However you cannot add duplicate TextElement objects to the Source. If it is detected that TextElement already exists within the Source, the request is ignored. You can always change the characteristics of a TextElement by using functions such as:
DTWAIN_SetPDFTextElementString DTWAIN_SetPDFTextElementFloatString (for computer languages that cannot use IEEE 64-bit floating point types) and those updated changes will be seen by the Source(s) that the text element was added to. The changes will also be seen while the images are being acquired. See Also |