Foxit PDF SDK

Public 成员函数 | 所有成员列表
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 | 新的导出映射名称。它不应该是空字符串。

返回
  无。