com.foxit.sdk.pdf.interform.Control类 参考

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

Public 成员函数
	Control (Control other)
	构造函数，使用另一个表单控件对象。 更多...
synchronized void	delete ()
	直接清除C++相关资源。 更多...
int	getAlignment () throws com.foxit.sdk.PDFException
	获取对齐值。 更多...
DefaultAppearance	getDefaultAppearance () throws com.foxit.sdk.PDFException
	获取默认外观数据。 更多...
String	getExportValue () throws com.foxit.sdk.PDFException
	当相关表单字段是复选框或单选按钮时，获取导出映射名称。 更多...
Field	getField () throws com.foxit.sdk.PDFException
	获取相关的表单字段。 更多...
int	getIndex () throws com.foxit.sdk.PDFException
	获取当前表单控件在相关表单字段的所有控件中的索引。 更多...
Widget	getWidget () throws com.foxit.sdk.PDFException
	获取相关的控件注释。 更多...
PDFDictionary	getWidgetDict () throws com.foxit.sdk.PDFException
	获取相关控件注释的字典。 更多...
boolean	isChecked () throws com.foxit.sdk.PDFException
	检查当相关表单字段是复选框或单选按钮时，当前表单控件是否被选中。 更多...
boolean	isDefaultChecked () throws com.foxit.sdk.PDFException
	检查当相关表单字段是复选框或单选按钮时，当前表单控件是否默认被选中。 更多...
boolean	isEmpty ()
	检查当前对象是否为空。 更多...
void	setAlignment (int alignment) throws com.foxit.sdk.PDFException
	设置当前表单控件的对齐属性。 更多...
void	setChecked (boolean checked_status) throws com.foxit.sdk.PDFException
	当相关表单字段是复选框或单选按钮时，设置当前表单控件的选中状态。 更多...
void	setDefaultAppearance (DefaultAppearance default_ap) throws com.foxit.sdk.PDFException
	设置默认外观数据。 更多...
void	setDefaultChecked (boolean checked_status) throws com.foxit.sdk.PDFException
	当相关表单字段是复选框或单选按钮时，设置当前表单控件的默认选中状态。 更多...
void	setExportValue (String value) throws com.foxit.sdk.PDFException
	当相关表单字段是复选框或单选按钮时，设置导出映射名称。 更多...

详细描述

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

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

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

参见

Form

Field

构造及析构函数说明

Control()

com.foxit.sdk.pdf.interform.Control.Control

(

Control

other

)

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

参数

[in]

other

另一个表单控件对象。

成员函数说明

delete()

synchronized void com.foxit.sdk.pdf.interform.Control.delete

(

)

直接清除C++相关资源。

返回

无。

注解

一旦这个接口被调用，这个对象将不能再被使用。

重载 com.foxit.sdk.common.Base .

getAlignment()

int com.foxit.sdk.pdf.interform.Control.getAlignment

(

)

throws com.foxit.sdk.PDFException

获取对齐值。

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

返回

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

getDefaultAppearance()

DefaultAppearance com.foxit.sdk.pdf.interform.Control.getDefaultAppearance

(

)

throws com.foxit.sdk.PDFException

获取默认外观数据。

返回

默认外观数据。

getExportValue()

String com.foxit.sdk.pdf.interform.Control.getExportValue

(

)

throws com.foxit.sdk.PDFException

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

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

返回

导出映射名称。

getField()

Field com.foxit.sdk.pdf.interform.Control.getField

(

)

throws com.foxit.sdk.PDFException

获取相关的表单字段。

返回

相关的表单字段对象。

getIndex()

int com.foxit.sdk.pdf.interform.Control.getIndex

(

)

throws com.foxit.sdk.PDFException

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

返回

表单控件的索引。

getWidget()

Widget com.foxit.sdk.pdf.interform.Control.getWidget

(

)

throws com.foxit.sdk.PDFException

获取相关的控件注释。

返回

相关的控件注释。

getWidgetDict()

PDFDictionary com.foxit.sdk.pdf.interform.Control.getWidgetDict

(

)

throws com.foxit.sdk.PDFException

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

返回

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

isChecked()

boolean com.foxit.sdk.pdf.interform.Control.isChecked

(

)

throws com.foxit.sdk.PDFException

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

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

返回

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

isDefaultChecked()

boolean com.foxit.sdk.pdf.interform.Control.isDefaultChecked

(

)

throws com.foxit.sdk.PDFException

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

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

返回

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

isEmpty()

boolean com.foxit.sdk.pdf.interform.Control.isEmpty

(

)

检查当前对象是否为空。

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

返回

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

setAlignment()

void com.foxit.sdk.pdf.interform.Control.setAlignment

(

int

alignment

)

throws com.foxit.sdk.PDFException

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

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

参数

[in]

alignment

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

返回

无。

setChecked()

void com.foxit.sdk.pdf.interform.Control.setChecked

(

boolean

checked_status

)

throws com.foxit.sdk.PDFException

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

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

参数

[in]

checked_status

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

返回

无。

setDefaultAppearance()

void com.foxit.sdk.pdf.interform.Control.setDefaultAppearance

(

DefaultAppearance

default_ap

)

throws com.foxit.sdk.PDFException

设置默认外观数据。

参数

[in]

default_ap

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

返回

无。

setDefaultChecked()

void com.foxit.sdk.pdf.interform.Control.setDefaultChecked

(

boolean

checked_status

)

throws com.foxit.sdk.PDFException

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

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

参数

[in]

checked_status

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

返回

无。

setExportValue()

void com.foxit.sdk.pdf.interform.Control.setExportValue

(

String

value

)

throws com.foxit.sdk.PDFException

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

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

参数

[in]

value

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

返回

无。