PoDoFo  0.9.1
Public Member Functions | Protected Member Functions
PoDoFo::PdfListField Class Reference

#include <PdfField.h>

Inheritance diagram for PoDoFo::PdfListField:
PoDoFo::PdfComboBox PoDoFo::PdfListBox

List of all members.

Public Member Functions

 PdfListField (const PdfField &rhs)
void InsertItem (const PdfString &rsValue, const PdfString &rsDisplayName=PdfString::StringNull)
void RemoveItem (int nIndex)
const PdfString GetItem (int nIndex) const
const PdfString GetItemDisplayText (int nIndex) const
size_t GetItemCount () const
void SetSelectedItem (int nIndex)
int GetSelectedItem () const
bool IsComboBox () const
void SetSpellcheckingEnabled (bool bSpellcheck)
bool IsSpellcheckingEnabled () const
void SetSorted (bool bSorted)
bool IsSorted () const
void SetMultiSelect (bool bMulti)
bool IsMultiSelect () 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

Protected Member Functions

 PdfListField (EPdfField eField, PdfAnnotation *pWidget, PdfAcroForm *pParent)
 PdfListField (EPdfField eField, PdfPage *pPage, const PdfRect &rRect, PdfAcroForm *pParent)
 PdfListField (EPdfField eField, PdfPage *pPage, const PdfRect &rRect, PdfDocument *pDoc)
 PdfListField (EPdfField eField, PdfPage *pPage, const PdfRect &rRect, PdfStreamedDocument *pDoc)
- 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 list of items in a PDF file. You cannot create this object directly, use PdfComboBox or PdfListBox instead.

See also:
PdfComboBox
PdfListBox

Constructor & Destructor Documentation

PoDoFo::PdfListField::PdfListField ( EPdfField  eField,
PdfAnnotation pWidget,
PdfAcroForm *  pParent 
)
protected

Create a new PdfTextField

PoDoFo::PdfListField::PdfListField ( EPdfField  eField,
PdfPage pPage,
const PdfRect rRect,
PdfAcroForm *  pParent 
)
protected

Create a new PdfTextField

PoDoFo::PdfListField::PdfListField ( EPdfField  eField,
PdfPage pPage,
const PdfRect rRect,
PdfDocument pDoc 
)
protected

Create a new PdfTextField

PoDoFo::PdfListField::PdfListField ( EPdfField  eField,
PdfPage pPage,
const PdfRect rRect,
PdfStreamedDocument pDoc 
)
protected

Create a new PdfTextField

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

Create a PdfListField from a PdfField

Parameters:
rhsa PdfField that is a list field

Internal usage only.


Member Function Documentation

const PdfString PoDoFo::PdfListField::GetItem ( int  nIndex) const
Parameters:
nIndexindex of the item
Returns:
the value of the item at the specified index
size_t PoDoFo::PdfListField::GetItemCount ( ) const
Returns:
the number of items in this list
const PdfString PoDoFo::PdfListField::GetItemDisplayText ( int  nIndex) const
Parameters:
nIndexindex of the item
Returns:
the display text of the item or if it has no display text its value is returned. This call is equivalent to GetItem() in this case
See also:
GetItem
int PoDoFo::PdfListField::GetSelectedItem ( ) const

Sets the currently selected item

Returns:
the selected item or -1 if no item was selected
void PoDoFo::PdfListField::InsertItem ( const PdfString rsValue,
const PdfString rsDisplayName = PdfString::StringNull 
)

Inserts a new item into the list

Parameters:
rsValuethe value of the item
rsDisplayNamean optional display string that is displayed in the viewer instead of the value
bool PoDoFo::PdfListField::IsComboBox ( ) const
inline
Returns:
true if this PdfListField is a PdfComboBox and false if it is a PdfListBox
bool PoDoFo::PdfListField::IsMultiSelect ( ) const
inline
Returns:
true if multi selection is enabled for this list
bool PoDoFo::PdfListField::IsSorted ( ) const
inline
Returns:
true if sorting is enabled
bool PoDoFo::PdfListField::IsSpellcheckingEnabled ( ) const
inline
Returns:
true if spellchecking is enabled for this combobox
void PoDoFo::PdfListField::RemoveItem ( int  nIndex)

Removes an item for the list

Parameters:
nIndexindex of the item to remove
void PoDoFo::PdfListField::SetMultiSelect ( bool  bMulti)
inline

Sets wether multiple items can be selected by the user in the list.

Parameters:
bMultiif true multiselect will be enabled

By default multiselection is turned off.

void PoDoFo::PdfListField::SetSelectedItem ( int  nIndex)

Sets the currently selected item

Parameters:
nIndexindex of the currently selected item
void PoDoFo::PdfListField::SetSorted ( bool  bSorted)
inline

Enable or disable sorting of items. The sorting does not happen in acrobat reader but whenever adding items using PoDoFo or another PDF editing application.

Parameters:
bSortedenable/disable sorting
void PoDoFo::PdfListField::SetSpellcheckingEnabled ( bool  bSpellcheck)
inline

Enable/disable spellchecking for this combobox

Parameters:
bSpellcheckif true spellchecking will be enabled

combobox are spellchecked by default