PoDoFo  0.9.1
Public Member Functions | List of all members
PoDoFo::PdfTextField Class Reference

#include <PdfField.h>

Inherits PoDoFo::PdfField.

Public Member Functions

 PdfTextField (PdfAnnotation *pWidget, PdfAcroForm *pParent)
 
 PdfTextField (PdfPage *pPage, const PdfRect &rRect, PdfAcroForm *pParent)
 
 PdfTextField (PdfPage *pPage, const PdfRect &rRect, PdfDocument *pDoc)
 
 PdfTextField (PdfPage *pPage, const PdfRect &rRect, PdfStreamedDocument *pDoc)
 
 PdfTextField (const PdfField &rhs)
 
void SetText (const PdfString &rsText)
 
PdfString GetText () const
 
void SetMaxLen (pdf_long nMaxLen)
 
pdf_long GetMaxLen () const
 
void SetMultiLine (bool bMultiLine)
 
bool IsMultiLine () const
 
void SetPasswordField (bool bPassword)
 
bool IsPasswordField () const
 
void SetFileField (bool bFile)
 
bool IsFileField () const
 
void SetSpellcheckingEnabled (bool bSpellcheck)
 
bool IsSpellcheckingEnabled () const
 
void SetScrollBarsEnabled (bool bScroll)
 
bool IsScrollBarsEnabled () const
 
void SetCombs (bool bCombs)
 
bool IsCombs () const
 
void SetRichText (bool bRichText)
 
bool IsRichText () const
 
- Public Member Functions inherited from PoDoFo::PdfField
 PdfField (PdfObject *pObject, PdfAnnotation *pWidget)
 
 PdfField (const PdfField &rhs)
 
PdfPageGetPage () const
 
void SetHighlightingMode (EPdfHighlightingMode eMode)
 
EPdfHighlightingMode GetHighlightingMode () const
 
void SetBorderColorTransparent ()
 
void SetBorderColor (double dGray)
 
void SetBorderColor (double dRed, double dGreen, double dBlue)
 
void SetBorderColor (double dCyan, double dMagenta, double dYellow, double dBlack)
 
void SetBackgroundColorTransparent ()
 
void SetBackgroundColor (double dGray)
 
void SetBackgroundColor (double dRed, double dGreen, double dBlue)
 
void SetBackgroundColor (double dCyan, double dMagenta, double dYellow, double dBlack)
 
void SetFieldName (const PdfString &rsName)
 
PdfString GetFieldName () const
 
void SetAlternateName (const PdfString &rsName)
 
PdfString GetAlternateName () const
 
void SetMappingName (const PdfString &rsName)
 
PdfString GetMappingName () const
 
void SetReadOnly (bool bReadOnly)
 
bool IsReadOnly () const
 
void SetRequired (bool bRequired)
 
bool IsRequired () const
 
void SetExport (bool bExport)
 
bool IsExport () const
 
EPdfField GetType () const
 

Additional Inherited Members

- Protected Member Functions inherited from PoDoFo::PdfField
 PdfField (EPdfField eField, PdfAnnotation *pWidget, PdfAcroForm *pParent)
 
void SetFieldFlag (long lValue, bool bSet)
 
bool GetFieldFlag (long lValue, bool bDefault) const
 
PdfObjectGetAppearanceCharacteristics (bool bCreate) const
 

Detailed Description

A textfield in a PDF file.

Users can enter text into a text field. Single and multi line text is possible, as well as richtext. The text can be interpreted as path to a file which is going to be submitted.

Constructor & Destructor Documentation

PoDoFo::PdfTextField::PdfTextField ( PdfAnnotation pWidget,
PdfAcroForm *  pParent 
)

Create a new PdfTextField

PoDoFo::PdfTextField::PdfTextField ( PdfPage pPage,
const PdfRect rRect,
PdfAcroForm *  pParent 
)

Create a new PdfTextField

PoDoFo::PdfTextField::PdfTextField ( PdfPage pPage,
const PdfRect rRect,
PdfDocument pDoc 
)

Create a new PdfTextField

PoDoFo::PdfTextField::PdfTextField ( PdfPage pPage,
const PdfRect rRect,
PdfStreamedDocument pDoc 
)

Create a new PdfTextField

PoDoFo::PdfTextField::PdfTextField ( const PdfField &  rhs)

Create a PdfTextField from a PdfField

Parameters
rhsa PdfField that is a PdfTextField

Raises an error if PdfField::GetType() != ePdfField_TextField

Member Function Documentation

pdf_long PoDoFo::PdfTextField::GetMaxLen ( ) const
Returns
the max length of this textfield in characters or -1 if no max length was specified
PdfString PoDoFo::PdfTextField::GetText ( ) const
Returns
the text contents of this text field
bool PoDoFo::PdfTextField::IsCombs ( ) const
inline
Returns
true if the text field is divided in to equal combs
bool PoDoFo::PdfTextField::IsFileField ( ) const
inline
Returns
true if the contents are treated as filename
bool PoDoFo::PdfTextField::IsMultiLine ( ) const
inline
Returns
true if this text field can contain multiple lines of text
bool PoDoFo::PdfTextField::IsPasswordField ( ) const
inline
Returns
true if this field is a password field that does not echo entered characters on the screen
bool PoDoFo::PdfTextField::IsRichText ( ) const
inline
Returns
true if this is a richtext text field
bool PoDoFo::PdfTextField::IsScrollBarsEnabled ( ) const
inline
Returns
true if scrollbars are enabled for this text field
bool PoDoFo::PdfTextField::IsSpellcheckingEnabled ( ) const
inline
Returns
true if spellchecking is enabled for this text field
void PoDoFo::PdfTextField::SetCombs ( bool  bCombs)
inline

Divide the text field into max-len equal combs.

Parameters
bCombsif true enable division into combs

By default coms are disabled. Requires the max len property to be set.

See Also
SetMaxLen
void PoDoFo::PdfTextField::SetFileField ( bool  bFile)
inline

Create a file selection field. The entered contents are treated as filename to a file whose contents are submitted as the value of the field.

Parameters
bFileif true the contents are treated as a pathname to a file to submit
void PoDoFo::PdfTextField::SetMaxLen ( pdf_long  nMaxLen)

Sets the max length in characters of this textfield

Parameters
nMaxLenthe max length of this textfields in characters
void PoDoFo::PdfTextField::SetMultiLine ( bool  bMultiLine)
inline

Create a multi-line text field that can contains multiple lines of text.

Parameters
bMultiLineif true a multi line field is generated, otherwise the text field can contain only a single line of text.

The default is to create a single line text field.

void PoDoFo::PdfTextField::SetPasswordField ( bool  bPassword)
inline

Create a password text field that should not echo entered characters visibly to the screen.

Parameters
bPasswordif true a password field is created

The default is to create no password field

void PoDoFo::PdfTextField::SetRichText ( bool  bRichText)
inline

Creates a richtext field.

Parameters
bRichTextif true creates a richtext field

By default richtext is disabled.

void PoDoFo::PdfTextField::SetScrollBarsEnabled ( bool  bScroll)
inline

Enable/disable scrollbars for this text field

Parameters
bScrollif true scrollbars will be enabled

Text fields have scrollbars by default

void PoDoFo::PdfTextField::SetSpellcheckingEnabled ( bool  bSpellcheck)
inline

Enable/disable spellchecking for this text field

Parameters
bSpellcheckif true spellchecking will be enabled

Text fields are spellchecked by default

void PoDoFo::PdfTextField::SetText ( const PdfString rsText)

Sets the text contents of this text field.

Parameters
rsTextthe text of this field