Okular::FormField Class Reference

#include <form.h>

Inheritance diagram for Okular::FormField:

Public Types
enum	AdditionalActionType { FieldModified, FormatField, ValidateField, CalculateField }
enum	FieldType { FormButton, FormText, FormChoice, FormSignature }

Public Member Functions
Action *	activationAction () const
Action *	additionalAction (AdditionalActionType type) const
Action *	additionalAction (Annotation::AdditionalActionType type) const
QList< Action * >	additionalActions () const
virtual QString	fullyQualifiedName () const =0
virtual int	id () const =0
virtual bool	isPrintable () const
virtual bool	isReadOnly () const
virtual bool	isVisible () const
virtual QString	name () const =0
Page *	page () const
virtual NormalizedRect	rect () const =0
virtual void	setPrintable (bool value)
virtual void	setReadOnly (bool value)
virtual void	setVisible (bool value)
FieldType	type () const
virtual QString	uiName () const =0

Protected Member Functions
void	setActivationAction (Action *action)
void	setAdditionalAction (AdditionalActionType type, Action *action)
void	setAdditionalAction (Annotation::AdditionalActionType type, Action *action)

Detailed Description

The base interface of a form field.

This is the very basic interface to represent a field in a form.

This is not meant to be used as a direct base for the form fields in a document, but its abstract subclasses are.

Definition at line 39 of file form.h.

Member Enumeration Documentation

AdditionalActionType

enum Okular::FormField::AdditionalActionType

Describes the type of form additional action.

Since

1.1

Enumerator
FieldModified	An action to be performed when the user modifies the field.
FormatField	An action to be performed before the field is formatted to display its value.
ValidateField	An action to be performed when the field value changes.
CalculateField	An action to be performed when the field needs to be recalculated.

Definition at line 139 of file form.h.

FieldType

enum Okular::FormField::FieldType

The types of form field.

Enumerator
FormButton	A "button". See FormFieldButton::ButtonType.
FormText	A field of variable text. See FormFieldText::TextType.
FormChoice	A choice field. See FormFieldChoice::ChoiceType.
FormSignature	A signature.

Definition at line 50 of file form.h.

Member Function Documentation

additionalAction()

Action * FormField::additionalAction

(

AdditionalActionType

type

)

const

Returns the additional action of the given type or nullptr if no action has been defined.

Since

1.1

Definition at line 93 of file form.cpp.

fullyQualifiedName()

virtual QString Okular::FormField::fullyQualifiedName ( ) const

pure virtual

The fully qualified name of the field, is used in the JavaScript scripts.

Since

1.9

id()

virtual int Okular::FormField::id ( ) const

pure virtual

The ID of the field.

isPrintable()

bool FormField::isPrintable ( ) const

virtual

Whether this field is printable.

Since

1.9

Definition at line 71 of file form.cpp.

isReadOnly()

bool FormField::isReadOnly ( ) const

virtual

Whether the field is read-only.

Definition at line 53 of file form.cpp.

isVisible()

bool FormField::isVisible ( ) const

virtual

Whether this form field is visible.

Definition at line 62 of file form.cpp.

name()

virtual QString Okular::FormField::name ( ) const

pure virtual

The internal name of the field, to be used when referring to the field in eg scripts.

page()

Page * FormField::page

(

)

const

Returns the page of this form field.

Since

21.12.2

Definition at line 126 of file form.cpp.

rect()

virtual NormalizedRect Okular::FormField::rect ( ) const

pure virtual

The bounding rect of the field, in normalized coordinates.

setPrintable()

void FormField::setPrintable ( bool  value )

virtual

Set this field printable.

Since

1.9

Definition at line 76 of file form.cpp.

setReadOnly()

void FormField::setReadOnly ( bool  value )

virtual

Whether the field is read-only.

Since

1.4

Definition at line 58 of file form.cpp.

setVisible()

void FormField::setVisible ( bool  value )

virtual

Whether the field is visible.

Since

1.5

Definition at line 67 of file form.cpp.

type()

FormField::FieldType FormField::type

(

)

const

The type of the field.

Definition at line 47 of file form.cpp.

uiName()

virtual QString Okular::FormField::uiName ( ) const

pure virtual

The visible name of the field, to be used in the user interface (eg in error messages, etc).

---

The documentation for this class was generated from the following files:

• form.h
• form.cpp