ImageGear for C and C++ on Linux v18.8 - Updated
IG_PDF_doc_form_flatten
API Reference Guide > PDF Component API Reference > PDF Component Objects Reference > General Objects > HIG_PDF_DOC > IG_PDF_doc_form_flatten

IG_PDF_doc_form_flatten

This function flattens a document's AcroForm fields into its page content.

Flattening form fields refers to the process of converting user-interactive field widget annotations into static page content. After flattening the fields, the interactive representation of the form is removed from the document.

Declaration:

AT_ERRCOUNT ACCUAPI IG_PDF_doc_form_flatten(
        HIG_PDF_DOC hDoc,    
        AT_INT flattenMode,
);

Arguments:

Name Type Description
hDoc HIG_PDF_DOC The document which fields are flattened on.
flattenMode AT_INT One of enumIGPDFFlattenMode, which specifies if flattening is done for screen or printer viewing. See remarks below.

Return Value:

Returns 0 if successful. Otherwise, returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

The visibility of each of the field after flattening depends on whether the HIDDEN, PRINT or NOVIEW flags are set in the field's widget annotations. These will be respected during flattening.

Flattening a signature field removes all visual information.