A3DPDFDocumentAppendPageFromPDFFileAndSuffixFields

A3DStatus A3DPDFDocumentAppendPageFromPDFFileAndSuffixFields(A3DPDFDocument *pDoc, const A3DUTF8Char *pcFileName, const A3DUTF8Char *pcAppendStringToFieldNames, A3DPDFPage **ppPage)

deprecated

A3DStatus A3DPDFDocumentAppendPageFromPDFFileAndSuffixFields(A3DPDFDocument* pDoc, const A3DUTF8Char* pcFileName, const A3DUTF8Char* pcAppendStringToFieldNames, A3DPDFPage** ppPage)

Appends new pages from a PDF template to a document, with the possibility to rename all form fields to avoid PDF conflicts. This method supersedes A3DPDFDocumentAppendPageFromPDFFile() in A3DLIBS 11.1 and later.

Starting from HOOPS Publish 6.0 the input PDF can contain several pages. The pages are added at the end of the document. All pages are copied from the PDF template file specified with the pcFileName argument.

If the imported pages contain form fields with names that already exist on other pages of the document, the function will fail. In this situation, set the pcAppendStringToFieldNames parameter to rename all form fields of the imported pages.

Parameters

pDoc: The Document object to work with.

pcFileName: The input file name of the PDF template.

pcAppendStringToFieldNames: The string that is appended to all form fields. Please see the details section below for more information.

ppPage: The Page object for the last page inserted.

Returns

A3D_SUCCESS in case of success or an error code