Index

  1. \SetaPDF
    1. FormFiller
    2. FormFiller
      1. Field
        1. Choice
        2. AbstractField
        3. AdditionalActions
        4. AppearanceValueCallbackInterface
        5. Button
        6. ButtonGroup
        7. Combo
        8. DefaultAppearanceData
        9. Exception
        10. FieldInterface
        11. Flags
        12. Formatter
        13. List
        14. PushButton
        15. Signature
        16. Text

SetaPDF_FormFiller_Field_AbstractField Abstract form field

File: /SetaPDF v2/FormFiller/Field/AbstractField.php

Class hierarchy

Summary

Methods

Properties

Properties

$_annotation

protected SetaPDF_Core_Document_Page_Annotation_Widget SetaPDF_FormFiller_Field_AbstractField::$_annotation

The annotation object of this form field

$_appearanceCanvas

protected SetaPDF_Core_Canvas SetaPDF_FormFiller_Field_AbstractField::$_appearanceCanvas

The canvas object of the appearance

$_defaultAppearanceData

protected SetaPDF_FormFiller_Field_DefaultAppearanceData SetaPDF_FormFiller_Field_AbstractField::$_defaultAppearanceData

$_fieldDictionary

protected SetaPDF_Core_Type_Dictionary SetaPDF_FormFiller_Field_AbstractField::$_fieldDictionary

The main field dictionary

$_fieldObject

protected SetaPDF_Core_Type_IndirectObject SetaPDF_FormFiller_Field_AbstractField::$_fieldObject

The fields indirect object

$_fields

protected SetaPDF_FormFiller_Fields SetaPDF_FormFiller_Field_AbstractField::$_fields

A reference to the fields instance

$_font

protected SetaPDF_Core_Font_FontInterface SetaPDF_FormFiller_Field_AbstractField::$_font

The font object, which should be used to create the appearance

$_fontSize

protected float|null SetaPDF_FormFiller_Field_AbstractField::$_fontSize

The font size, which should be used to create the appearance

$_lineHeightFactor

protected float SetaPDF_FormFiller_Field_AbstractField::$_lineHeightFactor

The factor to calculate the line height based on the font size

$_originalQualifiedName

protected string SetaPDF_FormFiller_Field_AbstractField::$_originalQualifiedName

The name without the suffix

$_page

protected SetaPDF_Core_Document_Page SetaPDF_FormFiller_Field_AbstractField::$_page

The page instance on which the form field is placed

$_qualifiedName

protected string SetaPDF_FormFiller_Field_AbstractField::$_qualifiedName

The name including a suffix if needed ("Text#1")

$_textColor

protected SetaPDF_Core_DataStructure_Color|null SetaPDF_FormFiller_Field_AbstractField::$_textColor

An individual color object which should be used for drawing the text appearance

$_textColorSpace

protected SetaPDF_Core_ColorSpace|null SetaPDF_FormFiller_Field_AbstractField::$_textColorSpace

An individual color space object which should be used for setting the non-stroking color space


Methods

__construct()

public SetaPDF_FormFiller_Field_AbstractField::__construct (
SetaPDF_FormFiller_Fields $fields, $qualifiedName, $fieldObject [, $originalQualifiedName = null ]
)

The constructor.

Parameters
$fields : SetaPDF_FormFiller_Fields

The fields instance

$qualifiedName

The qualified name of the field

$fieldObject
 
$originalQualifiedName

The original qualified name of the field

_checkPermission()

protected SetaPDF_FormFiller_Field_AbstractField::_checkPermission (): void

Checks for form-filling permissions.

Parameters
$permission
 
Exceptions

Throws SetaPDF_Core_SecHandler_Exception

_getAppearanceReference()

protected SetaPDF_FormFiller_Field_AbstractField::_getAppearanceReference (
void
):

Get the reference to the normal appearance stream object.

_getBorderWidthAndStyle()

protected SetaPDF_FormFiller_Field_AbstractField::_getBorderWidthAndStyle (
void
):

Resolve the border width and style

_getFontRelation()

protected SetaPDF_FormFiller_Field_AbstractField::_getFontRelation (
SetaPDF_Core_Type_Dictionary $nDictionary, &$fontName
):

Get the font relation and copy the resources to the Resources entry if needed.

Parameters
$nDictionary : SetaPDF_Core_Type_Dictionary
 
$fontName
 
Exceptions

Throws SetaPDF_FormFiller_Exception

_postDelete()

protected SetaPDF_FormFiller_Field_AbstractField::_postDelete (
void
):

A method called after deleting a field.

This method forwards the deletion info to the fields instance.

_preDelete()

protected SetaPDF_FormFiller_Field_AbstractField::_preDelete (
void
):

A method called before deleting a field.

This method forwards the deletion info to the fields instance.

_preFlatten()

protected SetaPDF_FormFiller_Field_AbstractField::_preFlatten (
void
):

A method called before flattening a field.

This method forwards the flatten info to the fields instance.

_recreateAppearance()

protected SetaPDF_FormFiller_Field_AbstractField::_recreateAppearance (
[ $circle = false [, $canvas = null ]]
):

Recreate or creates the background appearance of the form field.

Parameters
$circle
 
$canvas
 

cleanUp()

public SetaPDF_FormFiller_Field_AbstractField::cleanUp (
void
):

Release cycled references and release memory.

delete()

public SetaPDF_FormFiller_Field_AbstractField::delete (
void
):

Delete the field.

Exceptions

Throws SetaPDF_FormFiller_Field_Exception

flatten()

public SetaPDF_FormFiller_Field_AbstractField::flatten (
void
): void

Flatten the field to the pages content stream.

See

getAnnotation()

public SetaPDF_FormFiller_Field_AbstractField::getAnnotation (
void
):

Get the widget annotation object from this field.

getAppearanceCanvas()

public SetaPDF_FormFiller_Field_AbstractField::getAppearanceCanvas (
void
):

Get the appearance canvas of the "normal" appearance object.

getAppearanceFont()

public SetaPDF_FormFiller_Field_AbstractField::getAppearanceFont (
void
):

Get the appearance font object.

getAppearanceFontSize()

public SetaPDF_FormFiller_Field_AbstractField::getAppearanceFontSize (
void
):

Get the appearance font size.

Exceptions

Throws SetaPDF_FormFiller_Field_Exception

getAppearanceTextColor()

public SetaPDF_FormFiller_Field_AbstractField::getAppearanceTextColor (
void
):

Get the individual appearance text color.

getAppearanceTextColorSpace()

public SetaPDF_FormFiller_Field_AbstractField::getAppearanceTextColorSpace (
void
):

Get the individual color space object which should be used for setting the non-stroking color space.

getDefaultAppearanceData()

public SetaPDF_FormFiller_Field_AbstractField::getDefaultAppearanceData (
void
):

Get the default appearance data of the DA value.

Exceptions

Throws SetaPDF_FormFiller_Field_Exception

getFieldDictionary()

public SetaPDF_FormFiller_Field_AbstractField::getFieldDictionary (
void
):

Get the field dictionary.

getFieldFlags()

public SetaPDF_FormFiller_Field_AbstractField::getFieldFlags (
void
):

Returns the current field flags.

getFieldObject()

public SetaPDF_FormFiller_Field_AbstractField::getFieldObject (
void
):

Get the indirect object of the form field.

getFields()

public SetaPDF_FormFiller_Field_AbstractField::getFields (
void
):

Get the fields instance.

getLineHeightFactor()

public SetaPDF_FormFiller_Field_AbstractField::getLineHeightFactor (
void
):

Get the line height factor

The line height is calculated by this factor in relation to the font size:

$lineHeight = $fontSize * $lineHeightFactor

By default this value is calculated by the font bounding box values "ury - lly / 1000".

See

getName()

public SetaPDF_FormFiller_Field_AbstractField::getName (
void
):

Alias for getQualifiedName().

See

getNoExport()

public SetaPDF_FormFiller_Field_AbstractField::getNoExport (
void
):

Checks if the no-export flag is set.

getNormalAppearanceObject()

public SetaPDF_FormFiller_Field_AbstractField::getNormalAppearanceObject (
[ $createNew = false ]
):

Get or create the normal appearance object (the object referenced in the N entry).

Parameters
$createNew

Pass true to force a recreation

getOriginalQualifiedName()

public SetaPDF_FormFiller_Field_AbstractField::getOriginalQualifiedName (
void
):

Get the original qualified name (without suffix).

getPage()

public SetaPDF_FormFiller_Field_AbstractField::getPage (
void
):

Gets the page object on which the form field is placed.

Exceptions

Throws SetaPDF_FormFiller_Field_Exception

getPageNumber()

public SetaPDF_FormFiller_Field_AbstractField::getPageNumber (
void
):

Get the page number on which the field appears.

getQualifiedName()

public SetaPDF_FormFiller_Field_AbstractField::getQualifiedName (
void
):

Returns the qualified name.

getTooltip()

public SetaPDF_FormFiller_Field_AbstractField::getTooltip (
[ $encoding = 'UTF-8' ]
):

Get the tooltip value.

Parameters
$encoding
 

isFieldFlagSet()

public SetaPDF_FormFiller_Field_AbstractField::isFieldFlagSet (
$flag
):

Checks if a specific field flag is set.

Parameters
$flag
 

isReadOnly()

public SetaPDF_FormFiller_Field_AbstractField::isReadOnly (
void
):

Checks if the field is set to read-only.

isRequired()

public SetaPDF_FormFiller_Field_AbstractField::isRequired (
void
):

Checks if the field is set to be required.

setAppearanceFont()

public SetaPDF_FormFiller_Field_AbstractField::setAppearanceFont (
SetaPDF_Core_Font_FontInterface $font [, $size = null ]
): void

Set the appearance font object.

Parameters
$font : SetaPDF_Core_Font_FontInterface
 
$size
 

setAppearanceFontSize()

public SetaPDF_FormFiller_Field_AbstractField::setAppearanceFontSize (
$fontSize
): void

Set an individual font size.

Parameters
$fontSize
 

setAppearanceTextColor()

public SetaPDF_FormFiller_Field_AbstractField::setAppearanceTextColor (
[ SetaPDF_Core_DataStructure_Color|null $textColor = null ]
): void

Set an individual appearance text color.

Parameters
$textColor : SetaPDF_Core_DataStructure_Color|null
 

setAppearanceTextColorSpace()

public SetaPDF_FormFiller_Field_AbstractField::setAppearanceTextColorSpace (
[ SetaPDF_Core_ColorSpace|null $colorSpace = null ]
): void

Set the individual color space object which should be used for setting the non-stroking color space.

Parameters
$colorSpace : SetaPDF_Core_ColorSpace|null
 

setFieldFlags()

public SetaPDF_FormFiller_Field_AbstractField::setFieldFlags (
$flags [, $add = true ]
): void

Sets a field flag.

Parameters
$flags
 
$add

Add = true, remove = false, set = null

setLineHeightFactor()

public SetaPDF_FormFiller_Field_AbstractField::setLineHeightFactor (
$lineHeightFactor
): void

Set the line height factor

The line height is calculated by this factor in relation to the font size:

$lineHeight = $fontSize * $lineHeightFactor

By default this value is calculated by the font bounding box values "ury - lly / 1000".

Parameters
$lineHeightFactor
 
See

setNoExport()

public SetaPDF_FormFiller_Field_AbstractField::setNoExport (
[ $noExport = true ]
): void

Set the no-export flag.

Parameters
$noExport
 

setReadOnly()

public SetaPDF_FormFiller_Field_AbstractField::setReadOnly (
[ $readOnly = true ]
): void

Sets the read-only flag.

Parameters
$readOnly
 

setRequired()

public SetaPDF_FormFiller_Field_AbstractField::setRequired (
[ $required = true ]
): void

Sets the required flag.

Parameters
$required
 

setTooltip()

public SetaPDF_FormFiller_Field_AbstractField::setTooltip (
$value [, $encoding = 'UTF-8' ]
): void

Set the tooltip value.

Parameters
$value
 
$encoding
 

unsetFieldFlags()

public SetaPDF_FormFiller_Field_AbstractField::unsetFieldFlags (
$flags
): void

Removes a field flag.

Parameters
$flags
 

© 2022 Setasign GmbH & Co. KG · Contact / Imprint · Data Privacy Statement (German)