foxit.pdf.interform.Control类 参考

类 foxit.pdf.interform.Control 继承关系图:

Public 成员函数
	Control (Control other)
	构造函数，使用另一个表单控件对象。 更多...
Alignment	GetAlignment ()
	获取对齐值。 更多...
DefaultAppearance	GetDefaultAppearance ()
	获取默认外观数据。 更多...
string	GetExportValue ()
	当相关表单字段是复选框或单选按钮时，获取导出映射名称。 更多...
Field	GetField ()
	获取相关的表单字段。 更多...
int	GetIndex ()
	获取当前表单控件在相关表单字段的所有控件中的索引。 更多...
Widget	GetWidget ()
	获取相关的控件注释。 更多...
PDFDictionary	GetWidgetDict ()
	获取相关控件注释的字典。 更多...
bool	IsChecked ()
	检查当相关表单字段是复选框或单选按钮时，当前表单控件是否被选中。 更多...
bool	IsDefaultChecked ()
	检查当相关表单字段是复选框或单选按钮时，当前表单控件是否默认被选中。 更多...
bool	IsEmpty ()
	检查当前对象是否为空。 更多...
void	SetAlignment (Alignment alignment)
	设置当前表单控件的对齐属性。 更多...
void	SetChecked (bool checked_status)
	当相关表单字段是复选框或单选按钮时，设置当前表单控件的选中状态。 更多...
void	SetDefaultAppearance (DefaultAppearance default_ap)
	设置默认外观数据。 更多...
void	SetDefaultChecked (bool checked_status)
	当相关表单字段是复选框或单选按钮时，设置当前表单控件的默认选中状态。 更多...
void	SetExportValue (string value)
	当相关表单字段是复选框或单选按钮时，设置导出映射名称。 更多...

详细描述

Foxit PDF SDK定义"表单控件"以将表单字段与其相关的控件注释关联。 表单字段可能有一个或多个表单控件，每个表单控件都与一个控件注释关联。 表单控件对象可以通过以下函数检索：

• 从表单，请使用函数Form.GetControl 。

• 从表单字段，请使用函数Field.GetControl 。

表单控件还提供获取相关表单字段对象和控件注释对象的函数。
函数Form.AddControl 可用于向表单字段添加新的表单控件，函数 Form.RemoveControl 可用于删除表单控件。

参见

Form

Field

构造及析构函数说明

Control()

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

inline

构造函数，使用另一个表单控件对象。

参数

[in]

other

另一个表单控件对象。

成员函数说明

GetAlignment()

Alignment foxit.pdf.interform.Control.GetAlignment ( )

inline

获取对齐值。

对齐是可变文本的属性，仅对作为相关表单字段的文本字段、列表框和 组合框有用，这些字段可能包含可变文本作为其内容。
如果相关表单字段是文本字段或列表框且有自己的对齐值， 则将忽略文档范围的默认对齐值； 否则，在这种情况下将使用文档范围的默认对齐值。

返回

对齐值。请参考从foxit.common.Alignment.e_AlignmentLeft 开始的值， 这将是其中一个值。

GetDefaultAppearance()

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

inline

获取默认外观数据。

返回

默认外观数据。

GetExportValue()

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

inline

当相关表单字段是复选框或单选按钮时，获取导出映射名称。

适用于复选框和单选按钮作为相关表单字段。 如果相关表单字段是其他字段类型，此函数将返回空字符串。

返回

导出映射名称。

GetField()

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

inline

获取相关的表单字段。

返回

相关的表单字段对象。

GetIndex()

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

inline

获取当前表单控件在相关表单字段的所有控件中的索引。

返回

表单控件的索引。

GetWidget()

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

inline

获取相关的控件注释。

返回

相关的控件注释。

GetWidgetDict()

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

inline

获取相关控件注释的字典。

返回

相关控件注释的字典。如果有任何错误，函数将返回null。

IsChecked()

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

inline

检查当相关表单字段是复选框或单选按钮时，当前表单控件是否被选中。

适用于复选框和单选按钮作为相关表单字段。 如果相关表单字段是其他字段类型，此函数将返回false。

返回

true 表示选中，false 表示未选中。

IsDefaultChecked()

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

inline

检查当相关表单字段是复选框或单选按钮时，当前表单控件是否默认被选中。

适用于复选框和单选按钮作为相关表单字段。 如果相关表单字段是其他字段类型，此函数将返回false。

返回

true 表示默认选中，false 表示默认未选中。

IsEmpty()

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

inline

检查当前对象是否为空。

当当前对象为空时，意味着当前对象无用。

返回

true 表示当前对象为空，false 表示非空。

SetAlignment()

void foxit.pdf.interform.Control.SetAlignment ( Alignment  alignment )

inline

设置当前表单控件的对齐属性。

对齐是可变文本的属性，仅对作为相关表单字段的文本字段、列表框和 组合框有用，这些字段可能包含可变文本作为其内容。
如果相关表单字段是文本字段或列表框且有自己的对齐值， 则将忽略文档范围的默认对齐值； 否则，在这种情况下将使用文档范围的默认对齐值。

参数

[in]

alignment

可变文本的新默认对齐类型。请参考从 foxit.common.Alignment.e_AlignmentLeft 开始的值，这应该是其中一个值。 如果使用其他值设置，默认将使用foxit.common.Alignment.e_AlignmentLeft 。

返回

无。

SetChecked()

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

inline

当相关表单字段是复选框或单选按钮时，设置当前表单控件的选中状态。

适用于复选框和单选按钮作为相关表单字段。 如果相关表单字段是其他字段类型，此函数不执行任何操作。

参数

[in]

checked_status

true 表示选中，false 表示未选中。

返回

无。

SetDefaultAppearance()

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

inline

设置默认外观数据。

参数

[in]

default_ap

新的默认外观。输入数据的flags可用于决定 哪些信息要用新数据更新；对于那些没有更新的数据， 它们将继续使用旧数据。 如果输入默认外观数据的text_size为0，意味着文本大小 应该自动计算。

返回

无。

SetDefaultChecked()

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

inline

当相关表单字段是复选框或单选按钮时，设置当前表单控件的默认选中状态。

适用于复选框和单选按钮作为相关表单字段。 如果相关表单字段是其他字段类型，此函数不执行任何操作。

参数

[in]

checked_status

true 表示默认选中，false 表示默认未选中。

返回

无。

SetExportValue()

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

inline

当相关表单字段是复选框或单选按钮时，设置导出映射名称。

适用于复选框和单选按钮作为相关表单字段。 如果相关表单字段是其他字段类型，此函数不执行任何操作。

参数

[in]

value

新的导出映射名称。它不应该是空字符串。

返回

无。