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

Public 成员函数
	Field (Field field)
	构造函数，使用另一个表单字段对象。更多...

	Field (PDFDoc document, PDFDictionary field_dict) throws com.foxit.sdk.PDFException
	从字段字典构造函数。更多...

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

int	getAlignment () throws com.foxit.sdk.PDFException
	获取对齐值。更多...

String	getAlternateName () throws com.foxit.sdk.PDFException
	获取备用名称。更多...

Control	getControl (int index) throws com.foxit.sdk.PDFException
	通过索引获取表单控件。更多...

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

int	getControlCount () throws com.foxit.sdk.PDFException
	获取表单控件数量。更多...

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

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

String	getDefaultValue () throws com.foxit.sdk.PDFException
	获取默认值。更多...

PDFObject	getDefaultValueObj () throws com.foxit.sdk.PDFException
	获取字段默认值的PDF对象。更多...

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

int	getFlags () throws com.foxit.sdk.PDFException
	获取字段标志。更多...

PDFObject	getInheritedAttribute (String attribute_name) throws com.foxit.sdk.PDFException
	获取指定属性的PDF对象，该属性可能从字段树中的祖先节点继承。更多...

String	getMappingName () throws com.foxit.sdk.PDFException
	获取映射名称。更多...

int	getMaxLength () throws com.foxit.sdk.PDFException
	获取字段文本的最大长度（以字符为单位）。更多...

String	getName () throws com.foxit.sdk.PDFException
	获取字段名称。更多...

ChoiceOptionArray	getOptions () throws com.foxit.sdk.PDFException
	获取列表框或组合框的选项。更多...

int	getTopVisibleIndex () throws com.foxit.sdk.PDFException
	获取可滚动列表框的选项顶部索引。更多...

int	getType () throws com.foxit.sdk.PDFException
	获取字段类型。更多...

String	getValue () throws com.foxit.sdk.PDFException
	获取值。更多...

PDFObject	getValueObj () throws com.foxit.sdk.PDFException
	获取字段值的PDF对象。更多...

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

boolean	reset () throws com.foxit.sdk.PDFException
	将当前字段中的数据重置为其默认值。（不支持签名字段）更多...

void	setAlignment (int alignment) throws com.foxit.sdk.PDFException
	设置表单的对齐属性，作为文档范围的默认值。（不支持签名字段）更多...

void	setAlternateName (String alternate_name) throws com.foxit.sdk.PDFException
	设置备用名称。（不支持签名字段）更多...

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

void	setDefaultValue (String value) throws com.foxit.sdk.PDFException
	设置默认值。更多...

void	setFlags (int flags) throws com.foxit.sdk.PDFException
	设置字段标志。更多...

void	setMappingName (String name) throws com.foxit.sdk.PDFException
	设置映射名称。（不支持签名字段）更多...

void	setMaxLength (int max_length) throws com.foxit.sdk.PDFException
	设置字段文本的最大长度（以字符为单位）。更多...

void	setOptions (ChoiceOptionArray option_array) throws com.foxit.sdk.PDFException
	设置列表框或组合框的选项。更多...

void	setTopVisibleIndex (int index) throws com.foxit.sdk.PDFException
	设置可滚动列表框的顶部索引。更多...

void	setValue (String value) throws com.foxit.sdk.PDFException
	设置值。更多...

静态 Public 属性
static final int	e_FlagButtonNoToggleToOff = 0x100
	（仅对单选按钮有用）如果设置，必须始终选择一个单选按钮；点击当前选择的按钮没有效果。如果清除，点击选择的按钮会取消选择它，不留下任何选择的按钮。

static final int	e_FlagButtonRadiosInUnison = 0x200
	（仅对单选按钮有用）如果设置，单选按钮字段内使用相同开启状态值的一组单选按钮将一致地开启和关闭；也就是如果一个被选中，它们都被选中。如果清除，按钮是互斥的。

static final int	e_FlagChoiceCommitOnSelChange = 0x400
	（仅对选择字段有用）如果设置，一旦用指点设备进行选择，新值就立即提交；如果清除，新值直到用户退出字段时才提交。

static final int	e_FlagChoiceMultiSelect = 0x100
	（仅对列表框有用）如果设置，可以同时选择多个项目； if clear, no more than one item at a time may be selected.

static final int	e_FlagChoiceSort = 0x200
	（仅对选择字段有用）如果设置，字段的选项项应按字母顺序排序。

static final int	e_FlagComboEdit = 0x100
	（仅对组合框有用）如果设置，组合框包括带有下拉列表的可编辑文本控件，如果清除，它只包括下拉列表。

static final int	e_FlagNoExport = 0x04
	如果设置，字段不能由提交表单操作导出。

static final int	e_FlagReadOnly = 0x01
	如果设置，用户不能更改字段的值。任何关联的控件注释将不会与用户交互；也就是说，它们不会响应鼠标点击或响应鼠标移动而改变外观。此标志对于其值被计算或从数据库导入的字段很有用。

static final int	e_FlagRequired = 0x02
	如果设置，字段在由提交表单操作导出时必须有一个值。

static final int	e_FlagTextComb = 0x2000
	（仅对文本字段有用）如果设置，使用梳状格式。更多...

static final int	e_FlagTextDoNotScroll = 0x1000
	（仅对文本字段有用）如果设置，字段不滚动（单行字段水平滚动，多行字段垂直滚动）以容纳超出其注释矩形的更多文本。一旦字段满了，就不再接受更多文本。

static final int	e_FlagTextFileSelect = 0x400
	（仅对文本字段有用）如果设置，在字段中输入的文本表示文件的路径名，其内容将作为字段的值提交。

static final int	e_FlagTextMultiline = 0x100
	（仅对文本字段有用）如果设置，文本字段可以包含多行文本；如果清除，字段的文本限制为单行。

static final int	e_FlagTextNoSpellCheck = 0x800
	（仅对文本字段有用）如果设置，在字段中输入的文本不进行拼写检查。

static final int	e_FlagTextPassword = 0x200
	（仅对文本字段有用）如果设置，字段用于输入不应在屏幕上可见回显的安全密码。从键盘输入的字符应该以某种不可读的形式回显，例如星号或项目符号字符。更多...

static final int	e_FlagTextRichText = 0x4000
	（仅对文本字段有用）如果设置，此字段的值应表示为富文本字符串。

static final int	e_TypeCheckBox = 2
	表单字段类型：复选框。

static final int	e_TypeComboBox = 4
	表单字段类型：组合框。

static final int	e_TypeListBox = 5
	表单字段类型：列表框。

static final int	e_TypePushButton = 1
	表单字段类型：按钮。

static final int	e_TypeRadioButton = 3
	表单字段类型：单选按钮。

static final int	e_TypeSignature = 7
	表单字段类型：签名字段。

static final int	e_TypeTextField = 6
	表单字段类型：文本字段。

static final int	e_TypeUnknown = 0
	表单字段类型：未知。

详细描述

在PDF文档中，表单字段出现在页面的任何组合上，所有这些字段组成一个跨越整个文档的单一全局交互式表单。函数Form.getField 可用于从交互式表单获取表单字段。此类提供了获取表单字段一些信息/属性、将表单字段重置为其默认值以及从表单字段获取表单控件的函数。
当表单字段的类型为com.foxit.sdk.pdf.interform.Field.e_TypeSignature 时，表单字段对象实际上是一个签名对象。
要访问附加操作，请使用Field对象构造com.foxit.sdk.pdf.actions.AdditionalAction 对象。

参见: Form; com.foxit.sdk.pdf.Signature; com.foxit.sdk.pdf.actions.AdditionalAction

构造及析构函数说明

◆ Field() [1/2]

com.foxit.sdk.pdf.interform.Field.Field	(	PDFDoc	document,
		PDFDictionary	field_dict
	)		throws com.foxit.sdk.PDFException

从字段字典构造函数。

参数

[in]	document	一个有效的PDF文档。
[in]	field_dict	表示表单字段的PDF字典。它应该属于参数document指定的PDF文档。

◆ Field() [2/2]

com.foxit.sdk.pdf.interform.Field.Field ( Field field )

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

参数

[in] field 另一个表单字段对象。

成员函数说明

◆ delete()

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

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

返回: 无。

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

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

被 com.foxit.sdk.pdf.Signature , 以及 com.foxit.sdk.pdf.PagingSealSignature 重载.

◆ getAlignment()

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

获取对齐值。

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

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

◆ getAlternateName()

String com.foxit.sdk.pdf.interform.Field.getAlternateName ( ) throws com.foxit.sdk.PDFException

获取备用名称。

备用字段名称用于在用户界面中必须标识字段的任何地方（例如在引用字段的错误或状态消息中）代替实际字段名称。此文本在提取文档内容以支持残障用户的可访问性或其他目的时也很有用。

返回: 备用名称。

◆ getControl() [1/2]

Control com.foxit.sdk.pdf.interform.Field.getControl ( int index ) throws com.foxit.sdk.PDFException

通过索引获取表单控件。

参数

[in] index 表单控件索引。有效范围：从0到(count-1)。 count由函数Field.getControlCount 返回。

返回: 表单控件对象。

◆ getControl() [2/2]

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

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

参数

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

返回: 表单控件对象。

◆ getControlCount() [1/2]

int com.foxit.sdk.pdf.interform.Field.getControlCount ( ) throws com.foxit.sdk.PDFException

获取表单控件数量。

返回: 表单控件的数量。

◆ getControlCount() [2/2]

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

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

参数

[in] page 有效的PDF页面对象。它应该与当前表单字段在同一文档中。

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

◆ getDefaultAppearance()

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

获取默认外观数据。

返回: 默认外观数据。

◆ getDefaultValue()

String com.foxit.sdk.pdf.interform.Field.getDefaultValue ( ) throws com.foxit.sdk.PDFException

获取默认值。

适用于除按钮以外的所有字段。

返回: 默认值字符串。对于不适用的字段类型，将返回空字符串。

◆ getDefaultValueObj()

PDFObject com.foxit.sdk.pdf.interform.Field.getDefaultValueObj ( ) throws com.foxit.sdk.PDFException

获取字段默认值的PDF对象。

字段默认值的格式因字段类型而异。有关更多详细信息，请参考《PDF参考1.7》P676中的"表8.69 所有字段字典的通用条目"。

返回: PDF对象。如果没有"DV"条目或发生任何错误，此函数将返回null。

◆ getDict()

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

获取当前对象的PDF字典。

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

◆ getFlags()

int com.foxit.sdk.pdf.interform.Field.getFlags ( ) throws com.foxit.sdk.PDFException

获取字段标志。

字段标志指定表单字段的各种特征。

返回: 表单字段标志。请参考从com.foxit.sdk.pdf.interform.Field.e_FlagReadOnly 开始的值，这将是其中一个值或这些值的组合。

◆ getInheritedAttribute()

PDFObject com.foxit.sdk.pdf.interform.Field.getInheritedAttribute ( String attribute_name ) throws com.foxit.sdk.PDFException

获取指定属性的PDF对象，该属性可能从字段树中的祖先节点继承。

某些字段属性被指定为可继承的，例如"Ff"、"V"、"DV"等。请参考《PDF参考1.7》P675中的"表8.69 所有字段字典的通用条目"。如果没有由attribute_name指定的条目或发生任何错误，此函数将返回null。

参数

[in] attribute_name 要查找的属性名称。

返回: PDF对象。如果未找到，此函数将返回null。

◆ getMappingName()

String com.foxit.sdk.pdf.interform.Field.getMappingName ( ) throws com.foxit.sdk.PDFException

获取映射名称。

映射名称用于从文档导出交互式表单字段数据时使用。

返回: 映射名称。

◆ getMaxLength()

int com.foxit.sdk.pdf.interform.Field.getMaxLength ( ) throws com.foxit.sdk.PDFException

获取字段文本的最大长度（以字符为单位）。

适用于文本字段。对于不适用的字段类型，此函数将返回0。

返回: 字段文本的最大长度。

◆ getName()

String com.foxit.sdk.pdf.interform.Field.getName ( ) throws com.foxit.sdk.PDFException

获取字段名称。

返回: 字段名称字符串。

◆ getOptions()

ChoiceOptionArray com.foxit.sdk.pdf.interform.Field.getOptions ( ) throws com.foxit.sdk.PDFException

获取列表框或组合框的选项。

适用于列表框和组合框。对于不适用的字段类型，此函数将返回空数组。

返回: 包含选项的数组。

◆ getTopVisibleIndex()

int com.foxit.sdk.pdf.interform.Field.getTopVisibleIndex ( ) throws com.foxit.sdk.PDFException

获取可滚动列表框的选项顶部索引。

适用于列表框。对于不适用的字段类型，此函数将返回0。
选项的顶部索引是列表中第一个可见选项的索引。

返回: 列表框可见范围内第一项的索引。

◆ getType()

int com.foxit.sdk.pdf.interform.Field.getType ( ) throws com.foxit.sdk.PDFException

获取字段类型。

返回: 表单字段类型。请参考从com.foxit.sdk.pdf.interform.Field.e_TypeUnknown 开始的值，这将是其中一个值。

◆ getValue()

String com.foxit.sdk.pdf.interform.Field.getValue ( ) throws com.foxit.sdk.PDFException

获取值。

适用于除按钮以外的所有字段。对于不适用的字段类型，将返回空字符串。对于复选框和单选框，此函数将返回外观状态值。

返回: 值字符串。特别地，当当前字段是具有多个值的列表框字段时，只返回第一个值。

◆ getValueObj()

PDFObject com.foxit.sdk.pdf.interform.Field.getValueObj ( ) throws com.foxit.sdk.PDFException

获取字段值的PDF对象。

字段值的格式因字段类型而异。有关更多详细信息，请参考《PDF参考1.7》P676中的"表8.69 所有字段字典的通用条目"。

返回: PDF对象。如果没有"V"条目或发生任何错误，此函数将返回null。

◆ isEmpty()

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

检查当前对象是否为空。

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

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

被 com.foxit.sdk.pdf.Signature 重载.

◆ reset()

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

将当前字段中的数据重置为其默认值。（不支持签名字段）

返回: true 表示成功，false 表示当前表单字段是签名字段或失败。

◆ setAlignment()

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

设置表单的对齐属性，作为文档范围的默认值。（不支持签名字段）

对齐是可变文本的属性，仅对文本字段、列表框和组合框有用，这些字段可能包含可变文本作为其内容。
如果文本字段或列表框有自己的对齐值，则将忽略文档范围的默认对齐值；否则，将为文本字段或列表框使用文档范围的默认对齐值。
如果当前表单字段是签名字段，此函数不执行任何操作。

参数

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

返回: 无。

◆ setAlternateName()

void com.foxit.sdk.pdf.interform.Field.setAlternateName ( String alternate_name ) throws com.foxit.sdk.PDFException

设置备用名称。（不支持签名字段）

备用字段名称用于在用户界面中必须标识字段的任何地方（例如在引用字段的错误或状态消息中）代替实际字段名称。此文本在提取文档内容以支持残障用户的可访问性或其他目的时也很有用。
如果当前表单字段是签名字段，此函数不执行任何操作。

参数

[in] alternate_name 新的备用名称字符串。它不应该是空字符串。

返回: 无。

◆ setDefaultAppearance()

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

设置默认外观数据。

参数

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

返回: 无。

◆ setDefaultValue()

void com.foxit.sdk.pdf.interform.Field.setDefaultValue ( String value ) throws com.foxit.sdk.PDFException

设置默认值。

适用于除按钮以外的所有字段。对于不适用的字段类型，此函数不执行任何操作。

参数

[in] value 新的默认值字符串。它不应该是空字符串。

返回: 无。

◆ setFlags()

void com.foxit.sdk.pdf.interform.Field.setFlags ( int flags ) throws com.foxit.sdk.PDFException

设置字段标志。

字段标志指定表单字段的各种特征。

参数

[in] flags 新的表单字段标志。请参考从com.foxit.sdk.pdf.interform.Field.e_FlagReadOnly 开始的值，这应该是其中一个值或这些值的组合。

返回: 无。

◆ setMappingName()

void com.foxit.sdk.pdf.interform.Field.setMappingName ( String name ) throws com.foxit.sdk.PDFException

设置映射名称。（不支持签名字段）

映射名称用于从文档导出交互式表单字段数据时使用。如果当前表单字段是签名字段，此函数不执行任何操作。

参数

[in] name 新的映射名称字符串。它不应该是空字符串。

返回: 无。

◆ setMaxLength()

void com.foxit.sdk.pdf.interform.Field.setMaxLength ( int max_length ) throws com.foxit.sdk.PDFException

设置字段文本的最大长度（以字符为单位）。

适用于文本字段。对于不适用的字段类型，此函数不执行任何操作。

参数

[in] max_length 字段文本的新最大长度。它应该是非负数。

返回: 无。

◆ setOptions()

void com.foxit.sdk.pdf.interform.Field.setOptions ( ChoiceOptionArray option_array ) throws com.foxit.sdk.PDFException

设置列表框或组合框的选项。

适用于列表框和组合框。对于不适用的字段类型，此函数不执行任何操作。

参数

[in] option_array 要设置到列表框或组合框的选项数组。

返回: 无。

◆ setTopVisibleIndex()

void com.foxit.sdk.pdf.interform.Field.setTopVisibleIndex ( int index ) throws com.foxit.sdk.PDFException

设置可滚动列表框的顶部索引。

适用于列表框。对于不适用的字段类型，此函数不执行任何操作。
选项的顶部索引是列表中第一个可见选项的索引。

参数

[in] index 列表中第一个可见选项的索引。

返回: 无。

◆ setValue()

void com.foxit.sdk.pdf.interform.Field.setValue ( String value ) throws com.foxit.sdk.PDFException

设置值。

适用于除按钮以外的所有字段。对于不适用的字段类型，此函数不执行任何操作。
特别地，对于组合框和文本字段，当成功设置值时，此函数还将触发相关的计算和格式化事件并更新字段的外观。

参数

[in]

value

新值字符串。特别地，当当前字段是列表框字段时，此参数可以包含多个值：
当要设置多个值时，每个值应该用"()"包装。例如， "(ABC)(CCC)" 表示设置两个值 "ABC" 和 "CCC"。
如果值包含"()"或"\\"作为其内容，请在每个"()"或"\\"字符前添加额外的"\\"作为转义字符。例如：

"ABC" 表示设置值 "ABC"。
"(ABC)" 表示设置值 "ABC"。
"(ABC" 表示设置值 "(ABC"。
"(\\\\(ABC\\\\)\\\\(BBB\\\\)\\\\(CCC\\\\))" 表示设置值 "(ABC)(BBB)(CCC)"。
"456\\\\\\\\" 表示设置值 "456\\"。
"(\\\\(ABC\\\\))" 表示设置值 "(ABC)"。

返回: 无。

类成员变量说明

◆ e_FlagTextComb

final int com.foxit.sdk.pdf.interform.Field.e_FlagTextComb = 0x2000

static

（仅对文本字段有用）如果设置，使用梳状格式。

如果设置，字段自动分为与字段文本最大长度值相等的等间距位置或梳状格，文本被布局到这些梳状格中。

◆ e_FlagTextPassword

final int com.foxit.sdk.pdf.interform.Field.e_FlagTextPassword = 0x200

static

（仅对文本字段有用）如果设置，字段用于输入不应在屏幕上可见回显的安全密码。从键盘输入的字符应该以某种不可读的形式回显，例如星号或项目符号字符。

注解: 为了保护密码机密性，如果设置了此标志，查看器应用程序不应将文本字段的值存储在PDF文件中。

Public 成员函数

静态 Public 属性

详细描述

构造及析构函数说明

◆ Field() [1/2]

◆ Field() [2/2]

成员函数说明

◆ delete()

◆ getAlignment()

◆ getAlternateName()

◆ getControl() [1/2]

◆ getControl() [2/2]

◆ getControlCount() [1/2]

◆ getControlCount() [2/2]

◆ getDefaultAppearance()

◆ getDefaultValue()

◆ getDefaultValueObj()

◆ getDict()

◆ getFlags()

◆ getInheritedAttribute()

◆ getMappingName()

◆ getMaxLength()

◆ getName()

◆ getOptions()

◆ getTopVisibleIndex()

◆ getType()

◆ getValue()

◆ getValueObj()

◆ isEmpty()

◆ reset()

◆ setAlignment()

◆ setAlternateName()

◆ setDefaultAppearance()

◆ setDefaultValue()

◆ setFlags()

◆ setMappingName()

◆ setMaxLength()

◆ setOptions()

◆ setTopVisibleIndex()

◆ setValue()

类成员变量说明

◆ e_FlagTextComb

◆ e_FlagTextPassword