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

Public 成员函数
	Form (Form other)
	构造函数，使用另一个表单对象。更多...

	Form (PDFDoc document) throws com.foxit.sdk.PDFException
	构造函数，使用PDF文档。更多...

Control	addControl (PDFPage page, String field_name, int field_type, RectF rect) throws com.foxit.sdk.PDFException
	向指定表单字段添加新的表单控件。如果表单字段不存在，此函数也将添加表单字段。（不支持签名字段）更多...

synchronized void	delete ()
	直接清除C++相关资源。更多...

boolean	exportToCSV (StreamCallback csv_file, String pdf_file_name, boolean is_append) throws com.foxit.sdk.PDFException
	将表单数据导出到CSV文件。更多...

boolean	exportToCSV (String csv_file_path, String pdf_file_name, boolean is_append) throws com.foxit.sdk.PDFException
	将表单数据导出到CSV文件。更多...

boolean	exportToHTML (FileWriterCallback html_file, FieldArray field_array, boolean is_include) throws com.foxit.sdk.PDFException
	将指定表单字段的数据导出到HTML文件。更多...

boolean	exportToHTML (String html_file_path, FieldArray field_array, boolean is_include) throws com.foxit.sdk.PDFException
	将指定表单字段的数据导出到HTML文件。更多...

boolean	exportToTXT (FileWriterCallback txt_file, FieldArray field_array, boolean is_include) throws com.foxit.sdk.PDFException
	将指定表单字段的数据导出到TXT文件。更多...

boolean	exportToTXT (String txt_file_path, FieldArray field_array, boolean is_include) throws com.foxit.sdk.PDFException
	将指定表单字段的数据导出到TXT文件。更多...

boolean	exportToXML (FileWriterCallback xml_file, FieldArray field_array, boolean is_include) throws com.foxit.sdk.PDFException
	将指定表单字段的数据导出到XML文件。更多...

boolean	exportToXML (String file_path) throws com.foxit.sdk.PDFException
	将表单数据导出到XML文件。更多...

boolean	exportToXML (String file_path, FieldArray field_array, boolean is_include) throws com.foxit.sdk.PDFException
	将指定表单字段的数据导出到XML文件。更多...

void	fixPageFields (int page_index) throws com.foxit.sdk.PDFException
	修复在PDF页面中但无法被当前表单对象计数的字段。更多...

int	getAlignment () throws com.foxit.sdk.PDFException
	获取用作文档范围默认值的对齐值。更多...

Control	getControl (PDFPage page, int index) throws com.foxit.sdk.PDFException
	在指定PDF页面中通过索引获取表单控件。更多...

Control	getControlAtDevicePoint (PDFPage page, PointF point, float tolerance, int type, Matrix2D matrix) throws com.foxit.sdk.PDFException
	在设备坐标系统中的指定位置获取表单控件。更多...

Control	getControlAtPoint (PDFPage page, PointF point, float tolerance, int type) throws com.foxit.sdk.PDFException
	在PDF坐标系统中的指定位置获取表单控件。更多...

int	getControlCount (PDFPage page) throws com.foxit.sdk.PDFException
	获取指定PDF页面中的表单控件数量。更多...

DefaultAppearance	getDefaultAppearance () throws com.foxit.sdk.PDFException
	获取默认外观数据。更多...

PDFDictionary	getDict () throws com.foxit.sdk.PDFException
	获取当前对象的字典。更多...

PDFDoc	getDocument () throws com.foxit.sdk.PDFException
	获取与当前表单对象关联的PDF文档。更多...

Field	getField (int index, String filter) throws com.foxit.sdk.PDFException
	通过索引获取名称满足指定名称过滤器的表单字段。更多...

int	getFieldCount (String filter) throws com.foxit.sdk.PDFException
	获取名称满足指定名称过滤器的表单字段数量。更多...

FieldArray	getFieldsInCalculationOrder () throws com.foxit.sdk.PDFException
	获取按计算顺序排列的表单字段数组。更多...

Filler	getFormFiller () throws com.foxit.sdk.PDFException
	获取表单填写器。更多...

boolean	importFromXML (String file_path) throws com.foxit.sdk.PDFException
	从XML文件导入表单数据。更多...

boolean	isEmpty ()
	检查当前对象是否为空。更多...

boolean	moveControl (Control control, String field_name) throws com.foxit.sdk.PDFException
	将控件移动到由字段名称指定的字段。更多...

boolean	needConstructAppearances () throws com.foxit.sdk.PDFException
	检查加载表单控件时是否构造外观。更多...

void	removeControl (Control control) throws com.foxit.sdk.PDFException
	删除表单控件。（不支持从签名字段删除表单控件）更多...

void	removeField (Field field) throws com.foxit.sdk.PDFException
	删除表单字段。（不支持签名字段）更多...

boolean	renameField (Field field, String new_field_name) throws com.foxit.sdk.PDFException
	用新名称重命名字段。更多...

boolean	reset () throws com.foxit.sdk.PDFException
	将所有字段（签名字段除外）的数据重置为其默认值。更多...

void	setAlignment (int alignment) throws com.foxit.sdk.PDFException
	设置用作文档范围默认值的对齐值。更多...

void	setConstructAppearances (boolean need_construct) throws com.foxit.sdk.PDFException
	设置指定加载表单控件时是否构造外观的标志。更多...

void	setDefaultAppearance (DefaultAppearance default_ap) throws com.foxit.sdk.PDFException
	设置默认外观数据。更多...

void	setFieldsInCalculationOrder (FieldArray field_array) throws com.foxit.sdk.PDFException
	设置按计算顺序排列的表单字段数组。更多...

boolean	validateFieldName (int type, String field_name) throws com.foxit.sdk.PDFException
	验证字段名称是否可用于指定字段类型的新字段。更多...

详细描述

交互式表单——有时称为AcroForm——是一个用于从用户交互式收集信息的字段集合。 PDF文档可能包含出现在页面任意组合上的任意数量的字段，所有这些字段构成跨越整个文档的单一全局交互式表单。这些字段的任意子集可以从文档导入或导出。
函数pdf.PDFDoc.hasForm 可用于判断PDF文档是否有交互式表单。
表单对象可以从指定的PDF文档构造。此类提供检索表单字段或表单控件、导入/导出表单数据和其他功能的函数。例如：

要检索表单字段，请使用函数Form.getFieldCount 和Form.getField 。
要从PDF页面检索表单控件，请使用函数Form.getControlCount 和 Form.getControl 。
要从XML文件导入表单数据，请使用函数Form.importFromXML ；要导出表单数据到XML文件，请使用函数Form.exportToXML 。
要检索表单填写器对象，请使用函数Form.getFormFiller 。

要从FDF/XFDF文件导入表单数据或将此类数据导出到FDF/XFDF文件，请参考函数 pdf.PDFDoc.importFromFDF 和pdf.PDFDoc.exportToFDF 。
要填写表单，请通过当前表单对象构造表单填写器对象，或者如果此类对象已经构造，请通过函数Form.getFormFiller 检索填写器对象。（一个交互式表单只应有一个表单填写器对象）。

参见: com.foxit.sdk.pdf.PDFDoc; Filler

构造及析构函数说明

◆ Form() [1/2]

com.foxit.sdk.pdf.interform.Form.Form ( PDFDoc document ) throws com.foxit.sdk.PDFException

构造函数，使用PDF文档。

如果PDF文档没有AcroForm，此构造函数将向PDF文档添加一个空的AcroForm，以便稍后可以向PDF文档添加新字段。

参数

[in] document 有效的PDF文档。

◆ Form() [2/2]

com.foxit.sdk.pdf.interform.Form.Form ( Form other )

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

参数

[in] other 另一个表单对象。

成员函数说明

◆ addControl()

Control com.foxit.sdk.pdf.interform.Form.addControl	(	PDFPage	page,
		String	field_name,
		int	field_type,
		RectF	rect
	)		throws com.foxit.sdk.PDFException

向指定表单字段添加新的表单控件。如果表单字段不存在，此函数也将添加表单字段。（不支持签名字段）

应用程序可以使用此函数添加新的表单控件：

如果指定的表单字段存在，将创建新的表单控件并设置到字段。
如果指定的表单字段不存在，将根据参数field_name和field_type 创建新的表单字段并添加到表单，同时创建新的表单控件。

表单字段是否存在，将通过输入参数field_name和field_type来判断。
如果用户想要添加新的签名字段，请使用函数pdf.PDFPage.addSignature 而不是当前函数。
新添加的表单控件没有外观，因此用户应该使用Control类中的设置方法或相关PDF字段或控件注释中的设置方法来设置会影响外观的属性。类com.foxit.sdk.pdf.interform.Control 和Field 的一些设置方法可能直接更新外观，但仍建议调用相关控件注释的函数 annots.Annot.resetAppearanceStream 以确保外观确实会被更新。
对于按钮、复选框、单选按钮，如果用户在不设置任何属性的情况下直接调用函数 annots.Annot.resetAppearanceStream ，将使用默认外观样式：

按钮：在相关控件注释中，背景色（在MK字典中）= 0xC0C0C0，高亮模式 = com.foxit.sdk.pdf.annots.Annot.e_HighlightingPush 。
复选框/单选按钮：在相关控件注释中，边框宽度 = 1.0，边框样式 = com.foxit.sdk.pdf.annots.BorderInfo.e_Solid ，背景色（在MK字典中）= 0xFFFFFF，边框色（在MK字典中）= 0xFFFFFF。

参数

[in]	page	有效的PDF页面，将在其中添加新的表单控件。它应该属于与当前表单相同的PDF文档。
[in]	field_name	字段名称。它不应该是空字符串。
[in]	field_type	字段类型。请参考从com.foxit.sdk.pdf.interform.Field.e_TypePushButton 开始的值，这应该是其中一个值，除了com.foxit.sdk.pdf.interform.Field.e_TypeSignature 。如果这是com.foxit.sdk.pdf.interform.Field.e_TypeSignature ，此函数将抛出异常 com.foxit.sdk.common.Constants.e_ErrUnsupported 。
[in]	rect	新表单控件的矩形，指定在PDF页面中的位置。它应该在PDF坐标系统中。

返回: 新添加的表单控件对象。

◆ delete()

synchronized void com.foxit.sdk.pdf.interform.Form.delete ( )

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

返回: 无。

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

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

◆ exportToCSV() [1/2]

boolean com.foxit.sdk.pdf.interform.Form.exportToCSV	(	StreamCallback	csv_file,
		String	pdf_file_name,
		boolean	is_append
	)		throws com.foxit.sdk.PDFException

将表单数据导出到CSV文件。

参数

[in]	csv_file	用户实现的com.foxit.sdk.common.fxcrt.StreamCallback 对象，用于将表单数据保存到CSV文件。它不应该是null。请不要在写入回调函数中使用追加模式。
[in]	pdf_file_name	当前PDF文档的文件名。此文件名将写入CSV文件。可以是空字符串。
[in]	is_append	用于决定如果CSV文件存在时是否将表单数据追加到CSV文件的布尔值： true 表示将表单数据追加到现有CSV文件，false 表示不追加。

返回: true means success, while false means failure.

◆ exportToCSV() [2/2]

boolean com.foxit.sdk.pdf.interform.Form.exportToCSV	(	String	csv_file_path,
		String	pdf_file_name,
		boolean	is_append
	)		throws com.foxit.sdk.PDFException

将表单数据导出到CSV文件。

参数

[in]	csv_file_path	CSV文件的完整文件路径。这指定了表单数据将导出到的CSV文件。这不应该是空字符串。
[in]	pdf_file_name	当前PDF文档的文件名。此文件名将写入CSV文件。这可以是空字符串。
[in]	is_append	布尔值，用于决定如果CSV文件存在，表单数据是否追加到CSV文件： true 表示将表单数据追加到现有CSV文件，false 表示不追加。

返回: true 表示成功，false 表示失败。

◆ exportToHTML() [1/2]

boolean com.foxit.sdk.pdf.interform.Form.exportToHTML	(	FileWriterCallback	html_file,
		FieldArray	field_array,
		boolean	is_include
	)		throws com.foxit.sdk.PDFException

将指定表单字段的数据导出到HTML文件。

参数

[in]	html_file	用户实现的com.foxit.sdk.common.fxcrt.FileWriterCallback 对象，用于将指定表单字段的数据保存到HTML文件。它不应该是null。
[in]	field_array	表单字段数组。参数is_include将决定是否导出这些表单字段的数据。如果这是一个空数组，表示将导出所有表单字段的数据。
[in]	is_include	用于决定是否导出指定表单字段数据的布尔值： true 表示将导出指定表单字段的数据，false 表示不导出指定表单字段的数据。

返回: true 表示成功，false 表示失败。

◆ exportToHTML() [2/2]

boolean com.foxit.sdk.pdf.interform.Form.exportToHTML	(	String	html_file_path,
		FieldArray	field_array,
		boolean	is_include
	)		throws com.foxit.sdk.PDFException

将指定表单字段的数据导出到HTML文件。

参数

[in]	html_file_path	HTML文件的完整文件路径，指定表单字段的数据将导出到该文件。它不应该是空字符串。
[in]	field_array	表单字段数组。参数is_include将决定是否导出这些表单字段的数据。如果这是一个空数组，表示将导出所有表单字段的数据。
[in]	is_include	用于决定是否导出指定表单字段数据的布尔值： true 表示将导出指定表单字段的数据，false 表示不导出指定表单字段的数据。

返回: true 表示成功，false 表示失败。

◆ exportToTXT() [1/2]

boolean com.foxit.sdk.pdf.interform.Form.exportToTXT	(	FileWriterCallback	txt_file,
		FieldArray	field_array,
		boolean	is_include
	)		throws com.foxit.sdk.PDFException

将指定表单字段的数据导出到TXT文件。

参数

[in]	txt_file	用户实现的com.foxit.sdk.common.fxcrt.FileWriterCallback 对象，用于将指定表单字段的数据保存到TXT文件。它不应该是null。
[in]	field_array	表单字段数组。参数is_include将决定是否导出这些表单字段的数据。如果这是一个空数组，表示将导出所有表单字段的数据。
[in]	is_include	用于决定是否导出指定表单字段数据的布尔值： true 表示将导出指定表单字段的数据，false 表示不导出指定表单字段的数据。

返回: true 表示成功，false 表示失败。

◆ exportToTXT() [2/2]

boolean com.foxit.sdk.pdf.interform.Form.exportToTXT	(	String	txt_file_path,
		FieldArray	field_array,
		boolean	is_include
	)		throws com.foxit.sdk.PDFException

将指定表单字段的数据导出到TXT文件。

参数

[in]	txt_file_path	TXT文件的完整文件路径，指定表单字段的数据将导出到该文件。它不应该是空字符串。
[in]	field_array	表单字段数组。参数is_include将决定是否导出这些表单字段的数据。如果这是一个空数组，表示将导出所有表单字段的数据。
[in]	is_include	用于决定是否导出指定表单字段数据的布尔值： true 表示将导出指定表单字段的数据，false 表示不导出指定表单字段的数据。

返回: true 表示成功，false 表示失败。

◆ exportToXML() [1/3]

boolean com.foxit.sdk.pdf.interform.Form.exportToXML	(	FileWriterCallback	xml_file,
		FieldArray	field_array,
		boolean	is_include
	)		throws com.foxit.sdk.PDFException

将指定表单字段的数据导出到XML文件。

参数

[in]	xml_file	用户实现的com.foxit.sdk.common.fxcrt.FileWriterCallback 对象，用于将指定表单字段的数据保存到XML文件。这不应该是null。
[in]	field_array	表单字段数组。参数is_include将决定是否导出这些表单字段的数据。如果这是空数组，意味着将导出所有表单字段的数据。
[in]	is_include	布尔值，用于决定是否导出指定表单字段的数据： true 表示导出指定表单字段的数据，false 表示不导出指定表单字段的数据。

返回: true 表示成功，false 表示失败。

◆ exportToXML() [2/3]

boolean com.foxit.sdk.pdf.interform.Form.exportToXML ( String file_path ) throws com.foxit.sdk.PDFException

将表单数据导出到XML文件。

参数

[in] file_path XML文件的完整文件路径。这指定了表单数据将导出到的XML文件。

返回: true 表示成功，false 表示失败。

◆ exportToXML() [3/3]

boolean com.foxit.sdk.pdf.interform.Form.exportToXML	(	String	file_path,
		FieldArray	field_array,
		boolean	is_include
	)		throws com.foxit.sdk.PDFException

将指定表单字段的数据导出到XML文件。

参数

[in]	file_path	XML文件的完整文件路径，指定表单字段的数据将导出到此文件。
[in]	field_array	表单字段数组。参数is_include将决定是否导出这些表单字段的数据。如果这是空数组，意味着将导出所有表单字段的数据。
[in]	is_include	布尔值，用于决定是否导出指定表单字段的数据： true 表示导出指定表单字段的数据，false 表示不导出指定表单字段的数据。

返回: true 表示成功，false 表示失败。

◆ fixPageFields()

void com.foxit.sdk.pdf.interform.Form.fixPageFields ( int page_index ) throws com.foxit.sdk.PDFException

修复在PDF页面中但无法被当前表单对象计数的字段。

如果指定页面中有许多字段，可能会花费很长时间。

参数

[in] page_index 页面索引。有效范围：从0到(count-1)。 count由函数PDFDoc.getPageCount 返回。

返回: 无。

◆ getAlignment()

int com.foxit.sdk.pdf.interform.Form.getAlignment ( ) throws com.foxit.sdk.PDFException

获取用作文档范围默认值的对齐值。

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

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

◆ getControl()

Control com.foxit.sdk.pdf.interform.Form.getControl	(	PDFPage	page,
		int	index
	)		throws com.foxit.sdk.PDFException

在指定PDF页面中通过索引获取表单控件。

参数

[in]	page	有效的PDF页面对象。它应该属于与当前表单相同的PDF文档。
[in]	index	要检索的表单控件索引。有效范围：从0到(count-1)。 count由函数Field.getControlCount 使用相同参数page返回。

返回: 表单控件对象。

◆ getControlAtDevicePoint()

Control com.foxit.sdk.pdf.interform.Form.getControlAtDevicePoint	(	PDFPage	page,
		PointF	point,
		float	tolerance,
		int	type,
		Matrix2D	matrix
	)		throws com.foxit.sdk.PDFException

在设备坐标系统中的指定位置获取表单控件。

参数

[in]	page	有效的PDF页面对象。它应该与当前表单在同一文档中。
[in]	point	设备坐标系统中的位置。
[in]	tolerance	容差值。有效范围：0.0f到30.0f。
[in]	type	将检索其表单控件的字段类型。请参考从 com.foxit.sdk.pdf.interform.Field.e_TypeUnknown 开始的值，这应该是其中一个值。 com.foxit.sdk.pdf.interform.Field.e_TypeUnknown 表示不关心字段类型，只检索指定位置的第一个表单控件。
[in]	matrix	变换矩阵。通常这由函数 pdf.PDFPage.getDisplayMatrix 返回。如果这是null，当前函数将具有与函数Form.getControlAtPoint 相同的功能。默认值：null。

返回: 表单控件对象。如果返回的表单控件对象的函数Control.isEmpty 的返回值为true，则意味着指定位置周围没有合适的表单控件。

◆ getControlAtPoint()

Control com.foxit.sdk.pdf.interform.Form.getControlAtPoint	(	PDFPage	page,
		PointF	point,
		float	tolerance,
		int	type
	)		throws com.foxit.sdk.PDFException

在PDF坐标系统中的指定位置获取表单控件。

参数

[in]	page	有效的PDF页面对象。它应该与当前表单在同一文档中。
[in]	point	PDF坐标系统中的位置。
[in]	tolerance	容差值。有效范围：0.0f到30.0f。
[in]	type	将检索其表单控件的字段类型。请参考从 com.foxit.sdk.pdf.interform.Field.e_TypeUnknown 开始的值，这应该是其中一个值。 com.foxit.sdk.pdf.interform.Field.e_TypeUnknown 表示不关心字段类型，只检索指定位置的第一个表单控件。

返回: 表单控件对象。如果返回的表单控件对象的函数Control.isEmpty 的返回值为true，则意味着指定位置周围没有合适的表单控件。

◆ getControlCount()

int com.foxit.sdk.pdf.interform.Form.getControlCount ( PDFPage page ) throws com.foxit.sdk.PDFException

获取指定PDF页面中的表单控件数量。

参数

[in] page 有效的PDF页面对象。它应该属于与当前表单相同的PDF文档。

返回: 指定PDF页面中表单控件的数量。

◆ getDefaultAppearance()

DefaultAppearance com.foxit.sdk.pdf.interform.Form.getDefaultAppearance ( ) throws com.foxit.sdk.PDFException

获取默认外观数据。

返回: 默认外观数据。

◆ getDict()

PDFDictionary com.foxit.sdk.pdf.interform.Form.getDict ( ) throws com.foxit.sdk.PDFException

获取当前对象的字典。

返回: 当前对象的字典。如果有任何错误，此函数将返回null。

◆ getDocument()

PDFDoc com.foxit.sdk.pdf.interform.Form.getDocument ( ) throws com.foxit.sdk.PDFException

获取与当前表单对象关联的PDF文档。

返回: PDF文档对象。

◆ getField()

Field com.foxit.sdk.pdf.interform.Form.getField	(	int	index,
		String	filter
	)		throws com.foxit.sdk.PDFException

通过索引获取名称满足指定名称过滤器的表单字段。

参数

[in]	index	要检索的表单字段索引。有效范围：从0到(count-1)。 count由函数Form.getFieldCount 使用相同参数filter返回。
[in]	filter	过滤器字符串。如果这是空字符串，意味着计算所有表单字段；如果这是有效的，意味着计算那些名称部分匹配参数filter的表单字段。例如，如果参数filter是"text1"，过滤器将匹配text1.0、text1.2.0等；但不匹配test10或test11.1。默认值：空字符串。

返回: 表单字段对象。

◆ getFieldCount()

int com.foxit.sdk.pdf.interform.Form.getFieldCount ( String filter ) throws com.foxit.sdk.PDFException

获取名称满足指定名称过滤器的表单字段数量。

参数

[in] filter 过滤器字符串。如果这是空字符串，意味着计算所有表单字段；如果这是有效的，意味着计算那些名称部分匹配参数filter的表单字段。例如，如果参数filter是"text1"，过滤器将匹配text1.0、text1.2.0等；但不匹配test10或test11.1。
默认值：空字符串。

返回: 具有指定名称过滤器的表单字段数量。

◆ getFieldsInCalculationOrder()

FieldArray com.foxit.sdk.pdf.interform.Form.getFieldsInCalculationOrder ( ) throws com.foxit.sdk.PDFException

获取按计算顺序排列的表单字段数组。

计算顺序定义当任何字段的值更改时，字段值将重新计算的顺序。通常，这些字段具有计算操作。

返回: 按计算顺序排列的表单字段数组。

◆ getFormFiller()

Filler com.foxit.sdk.pdf.interform.Form.getFormFiller ( ) throws com.foxit.sdk.PDFException

获取表单填写器。

返回: 填写器对象。如果返回的填写器对象的函数Filler.isEmpty 的返回值为true，则意味着表单填写器尚未构造。对于这种情况，请使用当前表单构造填写器。

◆ importFromXML()

boolean com.foxit.sdk.pdf.interform.Form.importFromXML ( String file_path ) throws com.foxit.sdk.PDFException

从XML文件导入表单数据。

参数

[in] file_path 现有XML文件的完整文件路径。这指定了将从中导入表单数据的XML文件。

返回: true 表示成功，false 表示失败。

◆ isEmpty()

boolean com.foxit.sdk.pdf.interform.Form.isEmpty ( )

检查当前对象是否为空。

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

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

◆ moveControl()

boolean com.foxit.sdk.pdf.interform.Form.moveControl	(	Control	control,
		String	field_name
	)		throws com.foxit.sdk.PDFException

将控件移动到由字段名称指定的字段。

当前函数对不同情况的操作：

如果由字段名称指定的字段不存在，将使用字段名称创建新字段，控件将移动到此新字段。
如果由字段名称指定的字段存在且字段类型与控件当前所属的字段相同，控件将合并到此字段。
如果由字段名称指定的字段存在但字段类型与控件当前所属的字段不同，此函数将抛出异常com.foxit.sdk.common.Constants.e_ErrConflict 。

参数

[in]	control	有效的表单控件对象。
[in]	field_name	字段名称。它不应该是空字符串。

返回: true 表示成功，false 表示失败。

◆ needConstructAppearances()

boolean com.foxit.sdk.pdf.interform.Form.needConstructAppearances ( ) throws com.foxit.sdk.PDFException

检查加载表单控件时是否构造外观。

返回: true 表示加载表单控件时构造外观，false 表示不构造。

◆ removeControl()

void com.foxit.sdk.pdf.interform.Form.removeControl ( Control control ) throws com.foxit.sdk.PDFException

删除表单控件。（不支持从签名字段删除表单控件）

如果指定的表单控件是相关表单字段的唯一表单控件，相关表单字段也将被删除。

参数

[in] control 要删除的表单控件。如果相关表单字段的字段类型是 com.foxit.sdk.pdf.interform.Field.e_TypeSignature ，此函数将抛出异常com.foxit.sdk.common.Constants.e_ErrUnsupported 。

返回: 无。

◆ removeField()

void com.foxit.sdk.pdf.interform.Form.removeField ( Field field ) throws com.foxit.sdk.PDFException

删除表单字段。（不支持签名字段）

如果表单字段出现在多个PDF页面上，所有表示都将被删除。
如果用户想要删除签名字段，请使用函数pdf.PDFDoc.removeSignature 而不是当前函数。

参数

[in] field 要删除的表单字段。如果字段类型是com.foxit.sdk.pdf.interform.Field.e_TypeSignature ，此函数将抛出异常com.foxit.sdk.common.Constants.e_ErrUnsupported 。

返回: 无。

◆ renameField()

boolean com.foxit.sdk.pdf.interform.Form.renameField	(	Field	field,
		String	new_field_name
	)		throws com.foxit.sdk.PDFException

用新名称重命名字段。

参数

[in]	field	有效的表单字段对象。
[in]	new_field_name	新的字段名称。它不应该是空字符串。

返回: true 表示成功，false 表示失败。

◆ reset()

boolean com.foxit.sdk.pdf.interform.Form.reset ( ) throws com.foxit.sdk.PDFException

将所有字段（签名字段除外）的数据重置为其默认值。

返回: true 表示成功，false 表示失败。

◆ setAlignment()

void com.foxit.sdk.pdf.interform.Form.setAlignment ( int alignment ) throws com.foxit.sdk.PDFException

设置用作文档范围默认值的对齐值。

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

参数

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

返回: 无。

◆ setConstructAppearances()

void com.foxit.sdk.pdf.interform.Form.setConstructAppearances ( boolean need_construct ) throws com.foxit.sdk.PDFException

设置指定加载表单控件时是否构造外观的标志。

参数

[in] need_construct true 表示加载表单控件时构造外观， false 表示不构造。

返回: 无。

◆ setDefaultAppearance()

void com.foxit.sdk.pdf.interform.Form.setDefaultAppearance ( DefaultAppearance default_ap ) throws com.foxit.sdk.PDFException

设置默认外观数据。

参数

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

返回: 无。

◆ setFieldsInCalculationOrder()

void com.foxit.sdk.pdf.interform.Form.setFieldsInCalculationOrder ( FieldArray field_array ) throws com.foxit.sdk.PDFException

设置按计算顺序排列的表单字段数组。

计算顺序定义当任何字段的值更改时，字段值将重新计算的顺序。通常，这些字段具有计算操作。

参数

[in] field_array 表单字段数组，用于指定新的计算顺序。

返回: 无。

◆ validateFieldName()

boolean com.foxit.sdk.pdf.interform.Form.validateFieldName	(	int	type,
		String	field_name
	)		throws com.foxit.sdk.PDFException

验证字段名称是否可用于指定字段类型的新字段。

此方法可用于检查字段名称是否可用于指定字段类型的新字段。建议用户在使用函数Form.addControl 添加带有新控件的新字段之前调用此函数。

参数

[in]	type	字段类型，将为其验证输入的字段名称。
[in]	field_name	字符串值。它不应该是空字符串。

返回: true 表示输入的字段名称对指定字段类型有效，false 表示无效。

Public 成员函数

详细描述

构造及析构函数说明

◆ Form() [1/2]

◆ Form() [2/2]

成员函数说明

◆ addControl()

◆ delete()

◆ exportToCSV() [1/2]

◆ exportToCSV() [2/2]

◆ exportToHTML() [1/2]

◆ exportToHTML() [2/2]

◆ exportToTXT() [1/2]

◆ exportToTXT() [2/2]

◆ exportToXML() [1/3]

◆ exportToXML() [2/3]

◆ exportToXML() [3/3]

◆ fixPageFields()

◆ getAlignment()

◆ getControl()

◆ getControlAtDevicePoint()

◆ getControlAtPoint()

◆ getControlCount()

◆ getDefaultAppearance()

◆ getDict()

◆ getDocument()

◆ getField()

◆ getFieldCount()

◆ getFieldsInCalculationOrder()

◆ getFormFiller()

◆ importFromXML()

◆ isEmpty()

◆ moveControl()

◆ needConstructAppearances()

◆ removeControl()

◆ removeField()

◆ renameField()

◆ reset()

◆ setAlignment()

◆ setConstructAppearances()

◆ setDefaultAppearance()

◆ setFieldsInCalculationOrder()

◆ validateFieldName()