Text Field Module

Types

A3DPDFTextFieldData

A3DPDFETextAlignment

Fields

kA3DPDFLeft

kA3DPDFCentered

kA3DPDFRight

Functions

A3DStatus

A3DPDFTextFieldCreate

A3DStatus

A3DPDFPageInsertTextField

A3DStatus

A3DPDFPageInsertTextFieldInTable

A3DStatus

A3DPDFPageFieldTextSetValue

A3DStatus

A3DPDFTextFieldSetValue

Detailed Description

group a3d_pdffield_text

Module to access and define Text field.

This module describes the functions and structures that allow you to define a Text Field. A Text Field is an Acrobat Field.

Type Documentation

enum A3DPDFETextAlignment

Alignment of the text.

Version

7.2

Values:

enumerator kA3DPDFLeft

The text is left justified.

enumerator kA3DPDFCentered

The button is centered.

enumerator kA3DPDFRight

The button is right justified.

Function Documentation

A3DStatus A3DPDFTextFieldCreate(A3DPDFDocument *pDoc, const A3DPDFTextFieldData *pTextFieldData, A3DPDFTextField **ppTextField)

Function to create a text field.

The text field is primarily created with this function, and it should be positioned on the page with the function A3DPDFPageInsertTextField.

Version

7.2

Parameters:
  • pDoc[inout] The Document object to work with.

  • pTextFieldData[in] The text field parameters.

  • ppTextField[out] The text field created.

Return values:

A3D_SUCCESS

Returns:

A3D_SUCCESS in case of success or an error code

A3DStatus A3DPDFPageInsertTextField(A3DPDFPage *pPage, A3DPDFTextField *pTextField, const A3DPDFRectData *pRectData)

Function to insert a text field in a page.

The text field must have a name before inserting it.

Version

7.2

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

  • pTextField[in] The Text field object to insert on the page.

  • pRectData[in] The rectangle to specify the position on the page.

Return values:

A3D_SUCCESS

Returns:

A3D_SUCCESS in case of success or an error code

A3DStatus A3DPDFPageInsertTextFieldInTable(A3DPDFPage *pPage, A3DPDFTable *pTable, A3DPDFTextField *pTextField, A3DInt32 iRowIndex, A3DInt32 iColumnIndex)

Function to insert a text field in a table.

See also

Table Module.

Version

7.2

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

  • pTable[in] The Table object to insert in the table.

  • pTextField[in] The Text field object to insert in the table.

  • iRowIndex[in] The index of the row of the table’s cell to insert the button (start from 1)

  • iColumnIndex[in] The index of the column of the table’s cell to insert the button (start from 1)

Return values:

A3D_SUCCESS

Returns:

A3D_SUCCESS in case of success or an error code

A3DStatus A3DPDFPageFieldTextSetValue(A3DPDFPage *pPage, const A3DUTF8Char *pcFieldName, const A3DUTF8Char *pcValue)

Function to set the text of a text 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.

  • pcValue[in] The value to set to the text field. Text fields set as multiline can contain carriage return characters, they must be ‘\r’.

Return values:

A3D_SUCCESS

Returns:

A3D_SUCCESS in case of success or an error code

A3DStatus A3DPDFTextFieldSetValue(A3DPDFTextField *pTextField, const A3DUTF8Char *pcValue)

Function to set the text of a text form field.

Version

10.0

Parameters:
  • pTextField[inout] The Text field object to work with.

  • pcValue[in] The value to set to the text field. Text fields set as multiline can contain carriage return characters, they must be ‘\r’.

Return values:

A3D_SUCCESS

Returns:

A3D_SUCCESS in case of success or an error code