Foxit PDF SDK
foxit.pdf.interform.Control Class Reference
Inheritance diagram for foxit.pdf.interform.Control:
foxit.common.Base

Public Member Functions

 Control (Control other)
 Constructor, with another form control object. More...
 
DefaultAppearance GetDefaultAppearance ()
 Get the default appearance data. More...
 
string GetExportValue ()
 Get export mapping name when related form field is check box or radio button. More...
 
Field GetField ()
 Get the related form field. More...
 
int GetIndex ()
 Get the index of current form control among all the controls of related form field. More...
 
Widget GetWidget ()
 Get the related widget annotation. More...
 
PDFDictionary GetWidgetDict ()
 Get the dictionary of related widget annotation. More...
 
bool IsChecked ()
 Check if the current form control is checked when related form field is check box or radio button. More...
 
bool IsDefaultChecked ()
 Check if the current form control is checked by default when related form field is check box or radio button. More...
 
bool IsEmpty ()
 Check whether current object is empty or not. More...
 
void SetChecked (bool checked_status)
 Set the check state of current form control when related form field is check box or radio button. More...
 
void SetDefaultAppearance (DefaultAppearance default_ap)
 Set default appearance data. More...
 
void SetDefaultChecked (bool checked_status)
 Set the default check state of current form control when related form field is check box or radio button. More...
 
void SetExportValue (string value)
 Set export mapping name when related form field is check box or radio button. More...
 

Detailed Description

Foxit PDF SDK defines "form control" to associate form field with its related widget annotations. A form field may have one or more form controls, and each form control is associated with a widget annotation. A form control object can be retrieved by following functions:

Form control also offers functions to get related form field object and widget annotation object.
Function Form.AddControl can be used to add a new form control to a form field, and function Form.RemoveControl can be used to remove a form control.

See also
Form
Field

Constructor & Destructor Documentation

◆ Control()

foxit.pdf.interform.Control.Control ( Control  other)
inline

Constructor, with another form control object.

Parameters
[in]otherAnother form control object.

Member Function Documentation

◆ GetDefaultAppearance()

DefaultAppearance foxit.pdf.interform.Control.GetDefaultAppearance ( )
inline

Get the default appearance data.

Returns
The default appearance data.

◆ GetExportValue()

string foxit.pdf.interform.Control.GetExportValue ( )
inline

Get export mapping name when related form field is check box or radio button.

Applicable for check box and radio button as related form field. If related form field is other field type, this function will return an empty string.

Returns
The export mapping name.

◆ GetField()

Field foxit.pdf.interform.Control.GetField ( )
inline

Get the related form field.

Returns
The related form field object.

◆ GetIndex()

int foxit.pdf.interform.Control.GetIndex ( )
inline

Get the index of current form control among all the controls of related form field.

Returns
The index of the form control.

◆ GetWidget()

Widget foxit.pdf.interform.Control.GetWidget ( )
inline

Get the related widget annotation.

Returns
The related widget annotation.

◆ GetWidgetDict()

PDFDictionary foxit.pdf.interform.Control.GetWidgetDict ( )
inline

Get the dictionary of related widget annotation.

Returns
Dictionary of related widget annotation.

◆ IsChecked()

bool foxit.pdf.interform.Control.IsChecked ( )
inline

Check if the current form control is checked when related form field is check box or radio button.

Applicable for check box and radio button as related form field. If related form field is other field type, this function will return false.

Returns
true means checked, and false means not checked.

◆ IsDefaultChecked()

bool foxit.pdf.interform.Control.IsDefaultChecked ( )
inline

Check if the current form control is checked by default when related form field is check box or radio button.

Applicable for check box and radio button as related form field. If related form field is other field type, this function will return false.

Returns
true means checked by default, and false means not checked by default.

◆ IsEmpty()

bool foxit.pdf.interform.Control.IsEmpty ( )
inline

Check whether current object is empty or not.

When the current object is empty, that means current object is useless.

Returns
true means current object is empty, while false means not.

◆ SetChecked()

void foxit.pdf.interform.Control.SetChecked ( bool  checked_status)
inline

Set the check state of current form control when related form field is check box or radio button.

Applicable for check box and radio button as related form field. If related form field is other field type, this function will do nothing.

Parameters
[in]checked_statustrue means checked, and false means not checked.
Returns
None.

◆ SetDefaultAppearance()

void foxit.pdf.interform.Control.SetDefaultAppearance ( DefaultAppearance  default_ap)
inline

Set default appearance data.

Parameters
[in]default_apThe new default appearance. flags of input data can be used to decide which information is/are to be updated with the new data; for those no updated data, they will keep to use old data.
If text_size of input default appearance data is 0, that means the text size should be calculated automatically.
Returns
None.

◆ SetDefaultChecked()

void foxit.pdf.interform.Control.SetDefaultChecked ( bool  checked_status)
inline

Set the default check state of current form control when related form field is check box or radio button.

Applicable for check box and radio button as related form field. If related form field is other field type, this function will do nothing.

Parameters
[in]checked_statustrue means checked by default, and false means not checked by default.
Returns
None.

◆ SetExportValue()

void foxit.pdf.interform.Control.SetExportValue ( string  value)
inline

Set export mapping name when related form field is check box or radio button.

Applicable for check box and radio button as related form field. If related form field is other field type, this function will do nothing.

Parameters
[in]valueThe new export mapping name. It should not be an empty string.
Returns
None.