Interactive Layout Entities Module

Types

	A3DPDFFieldData
	A3DPDFEFieldType
	A3DPDFEFormField
	A3DPDFETextOrientation
	A3DPDFEThicknessBorder
	A3DPDFELineStyleBorder

Fields

	kA3DPDFText
	kA3DPDFButton
	kA3DPDFDropDown
	kA3DPDFListBox
	kA3DPDFCheckBox
	kA3DPDFRadioButton
	kA3DPDFDigitalSignature
	kA3DPDFBarCode
	kA3DPDFVisible
	kA3DPDFHidden
	kA3DPDFVisibleNoPrint
	kA3DPDFHiddenPrintable
	kA3DPDFNormal
	kA3DPDF90
	kA3DPDF180
	kA3DPDF270
	kA3DPDFThin
	kA3DPDFMedium
	kA3DPDFThick
	kA3DPDFSolid
	kA3DPDFDashed
	kA3DPDFBeveled
	kA3DPDFInset
	kA3DPDFUnderlined

Functions

A3DStatus	A3DPDFPageFieldListAddItem
A3DStatus	A3DPDFPageGetFields
A3DStatus	A3DPDFPageGetField
A3DStatus	A3DPDFFieldGetInformation
A3DStatus	A3DPDFWidgetGetPosition
A3DStatus	A3DPDFWidgetGetName
A3DStatus	A3DPDFPageFieldSetVisibility

Detailed Description

group a3d_pdf_widget_module

Module for interactive widgets on a PDF page.

This module describes the functions and structures that allow you to define or retrieve widgets on a PDF Page. Widgets are interactive entitities that can be modified with JavaScript coding at runtime. Functions exist to create widgets on a page, or retrieve widgets on an existing page.

Widgets are divided in two categories: the Fields, and the High Level widgets. Fields are Acrobat Forms entities existing on a page. These Fields can be authored using Acrobat. High Level widgets are HOOPS Publish entities. They usually are built from a set of Fields. High Level widgets can only be authored by HOOPS Publish functions.

Type Documentation

enum A3DPDFEFieldType

Field type.

Version

6.0

Values:

enumerator kA3DPDFText

Field of type ‘Text field’.

enumerator kA3DPDFButton

Field of type ‘Button’.

enumerator kA3DPDFDropDown

Field of type ‘Drop-down list’ (also named ‘Combo box’).

enumerator kA3DPDFListBox

Field of type ‘List Box’.

enumerator kA3DPDFCheckBox

Field of type ‘Check Box’.

enumerator kA3DPDFRadioButton

Field of type ‘Radio Button’.

enumerator kA3DPDFDigitalSignature

Field of type ‘Digital Signature’.

enumerator kA3DPDFBarCode

Field of type ‘Barcode’. Not used by Publish.

enum A3DPDFEFormField

Field flags.

Version

7.2

Values:

enumerator kA3DPDFVisible

The field is visible and printable.

enumerator kA3DPDFHidden

The field is hidden and not printable.

enumerator kA3DPDFVisibleNoPrint

The field is visible but not printable.

enumerator kA3DPDFHiddenPrintable

The field is hidden but printable.

enum A3DPDFETextOrientation

Orientation of the text in a field.

Version

7.2

Values:

enumerator kA3DPDFNormal

The text has a standard orientation.

enumerator kA3DPDF90

The button is turned 90 from counter clockwise.

enumerator kA3DPDF180

The button is turned 180 from counter clockwise.

enumerator kA3DPDF270

The button is turned 270 from counter clockwise.

enum A3DPDFEThicknessBorder

Thickness of the border of a field.

Version

7.2

Values:

enumerator kA3DPDFThin

The border of the field is thin.

enumerator kA3DPDFMedium

The border of the field is medium size.

enumerator kA3DPDFThick

The border of the field is thin.

enum A3DPDFELineStyleBorder

Line style of the border of a field.

Version

7.2

Values:

enumerator kA3DPDFSolid

Solid line.

enumerator kA3DPDFDashed

Dashed line.

enumerator kA3DPDFBeveled

Beveled line.

enumerator kA3DPDFInset

Inset line.

enumerator kA3DPDFUnderlined

Underlined.

Function Documentation

A3DStatus A3DPDFPageFieldListAddItem(A3DPDFPage *pPage, const A3DUTF8Char *pcFieldName, const A3DUTF8Char *pcItemValue, const A3DUTF8Char *pcItemExportValue)

Function to add an item to a form field of type list.

Version

4.3

Parameters:

• pPage – [inout] The Page object to work with.

• pcFieldName – [in] The name of the form field. Only Acroform fields are supported.

• pcItemValue – [in] The item string which will be visible to the user in the list field.

• pcItemExportValue – [in] The export value for the item. This value acts as a ‘symbolic value’ for the item.

Return values:

A3D_SUCCESS –

Returns:

A3D_SUCCESS in case of success or an error code

A3DStatus A3DPDFPageGetFields(A3DPDFPage *pPage, A3DInt32 *piNbFields, A3DPDFField ***pppFields)

Function to retrieve the fields of a PDF page. The fields supported are only form fields created with Acrobat. LiveCycle Designer fields (XFA) are not supported.

Memory Management

In case of success, pppFields contains heap allocated memory your are responsible for. To free the memory on pppFields, call A3DPDFPageGetFields with pPage set to 0.

Version

6.0

Parameters:

• pPage – [in] The Page object to work with.

• piNbFields – [out] The number of fields.

• pppFields – [out] The array of pointer on fields objects.

Return values:

A3D_SUCCESS –

Returns:

A3D_SUCCESS in case of success or an error code

A3DStatus A3DPDFPageGetField(A3DPDFPage *pPage, const A3DUTF8Char *pcFieldName, A3DPDFField **ppField)

Function to get a PDF Field from an existing form field on a page.

Version

10.0

Parameters:

• pPage – [in] The Page object on which is the field.

• pcFieldName – [in] Unique name for existing field.

• ppField – [out] The Field object.

Return values:

A3D_SUCCESS –

Returns:

A3D_SUCCESS in case of success or an error code

A3DStatus A3DPDFFieldGetInformation(A3DPDFField *pField, A3DPDFFieldData *pFieldData)

Function to retrieve useful information regarding a field of a document.

Version

6.0

Parameters:

• pField – [in] The Field object to work with.

• pFieldData – [out] Data structure completed by the function. Contains the attributes of the field.

A3DStatus A3DPDFWidgetGetPosition(A3DPDFWidget *pWidget, A3DPDFRectDData *pRect)

Function to retrieve the position of a widget on a page.

Widgets are fields or more high-level entities.

Version

10.0

Parameters:

• pWidget – [in] The Widget object to work with.

• pRect – [out] Data structure completed by the function. Contains the position of the widget.

A3DStatus A3DPDFWidgetGetName(A3DPDFWidget *pWidget, A3DUTF8Char **ppcWidgetId)

Function to retrieve the name (identifier) of a widget.

Widgets are fields or more high-level entities.

Memory Management

In case of success, ppcWidgetId contains heap allocated memory your are responsible for. To free the memory on ppcWidgetId, call A3DPDFWidgetGetName with pWidget set to 0.

Version

10.0

Parameters:

• pWidget – [in] The Widget object to work with.

• ppcWidgetId – [out] The identifier as a string.

A3DStatus A3DPDFPageFieldSetVisibility(A3DPDFPage *pPage, const A3DUTF8Char *pcFieldName, const A3DBool bIsVisible)

Function to set the visibility of a form field.

Version

4.1

Parameters:

• pPage – [inout] The Page object to work with.

• pcFieldName – [in] The name of the form field. Only Acroform fields are supported.

• bIsVisible – [in] Specifies if the field should be visible or not.

Return values:

A3D_SUCCESS –

Returns:

A3D_SUCCESS in case of success or an error code