Foxit PDF SDK

Public 成员函数 | 静态 Public 属性 | 所有成员列表
com.foxit.sdk.pdf.actions.AdditionalAction类 参考
类 com.foxit.sdk.pdf.actions.AdditionalAction 继承关系图:

## Public 成员函数
| AdditionalAction (AdditionalAction other)
| 构造函数，使用另一个附加动作对象。 更多...
| AdditionalAction (Annot annot) throws com.foxit.sdk.PDFException
| 构造函数，从PDF注释。 更多...
| AdditionalAction (Field field) throws com.foxit.sdk.PDFException
| 构造函数，从PDF表单字段。 更多...
| AdditionalAction (PDFDoc doc, PDFDictionary pdf_dict) throws com.foxit.sdk.PDFException
| 构造函数，从PDF文档或PDF字典（如果有）。 更多...
| AdditionalAction (PDFPage page) throws com.foxit.sdk.PDFException
| 构造函数，从PDF页面。 更多...
synchronized void | delete ()
| 直接清除C++相关资源。 更多...
boolean | doJSAction (int trigger) throws com.foxit.sdk.PDFException
| 执行由触发器事件类型指定的JavaScript动作。 更多...
Action | getAction (int trigger) throws com.foxit.sdk.PDFException
| 获取具有指定触发器事件类型的动作。 更多...
PDFDictionary | getDict () throws com.foxit.sdk.PDFException
| 获取当前对象的PDF字典。 更多...
boolean | isEmpty ()
| 检查当前对象是否为空。 更多...
boolean | removeAction (int trigger) throws com.foxit.sdk.PDFException
| 移除具有指定触发器事件类型的动作。 更多...
boolean | removeAllActions () throws com.foxit.sdk.PDFException
| 移除所有动作。 更多...
void | setAction (int trigger, Action action) throws com.foxit.sdk.PDFException
| 为指定的触发器事件类型设置附加动作。 更多...

## 静态 Public 属性
static final int | e_TriggerAnnotCursorEnter = 11
| 触发当光标进入注释的活动区域时执行的动作。 更多...
static final int | e_TriggerAnnotCursorExit = 12
| 触发当光标离开注释的活动区域时执行的动作。 更多...
static final int | e_TriggerAnnotLoseInputFocus = 16
| （仅适用于小部件注释）触发当注释失去输入焦点时执行的动作。 更多...
static final int | e_TriggerAnnotMouseButtonPressed = 13
| 触发当鼠标按钮在注释的活动区域内按下时执行的动作。 更多...
static final int | e_TriggerAnnotMouseButtonReleased = 14
| 触发当鼠标按钮在注释的活动区域内释放时执行的动作。 更多...
static final int | e_TriggerAnnotPageClosed = 18
| 触发当包含注释的页面关闭时执行的动作。 更多...
static final int | e_TriggerAnnotPageInvisible = 20
| 触发当包含注释的页面在查看器应用程序的用户界面中不再可见时执行的动作。 更多...
static final int | e_TriggerAnnotPageOpened = 17
| 触发当包含注释的页面打开时执行的动作。 更多...
static final int | e_TriggerAnnotPageVisible = 19
| 触发当包含注释的页面在查看器应用程序的用户界面中变为可见时执行的动作。 更多...
static final int | e_TriggerAnnotReceiveInputFocus = 15
| （仅适用于小部件注释）触发当注释接收输入焦点时执行的动作。 更多...
static final int | e_TriggerDocPrinted = 6
| 触发在打印文档后执行的JavaScript动作。 更多...
static final int | e_TriggerDocSaved = 4
| 触发在保存文档后执行的JavaScript动作。 更多...
static final int | e_TriggerDocWillClose = 2
| 触发在关闭文档前执行的JavaScript动作。 更多...
static final int | e_TriggerDocWillPrint = 5
| 触发在打印文档前执行的JavaScript动作。 更多...
static final int | e_TriggerDocWillSave = 3
| 触发在保存文档前执行的JavaScript动作。 更多...
static final int | e_TriggerFieldKeyStroke = 7
| 触发当用户在文本字段或组合框中输入按键或修改可滚动列表框中的选择时执行的JavaScript动作。 更多...
static final int | e_TriggerFieldRecalculateValue = 10
| 触发当另一个字段改变时重新计算此字段值的JavaScript动作。 更多...
static final int | e_TriggerFieldValueChanged = 9
| 触发当字段的值改变时执行的JavaScript动作。 更多...
static final int | e_TriggerFieldWillFormat = 8
| 触发在字段被格式化以显示其当前值之前执行的JavaScript动作。 更多...
static final int | e_TriggerPageClosed = 1
| 触发在页面关闭时执行的动作。 更多...
static final int | e_TriggerPageOpened = 0
| 触发在页面打开时执行的动作。 更多...

## 详细描述

注释、页面对象或（从PDF 1.3开始）交互式表单字段可能包含名为"AA"的条目， 该条目指定附加动作字典（PDF 1.2），扩展了可以触发动作执行的事件集。 在PDF 1.4中，文档目录字典也可能包含影响整个文档的触发事件的"AA"条目。
此类可以从PDF文档、PDF页面、PDF表单字段、PDF注释（仅某些类型）或 现有的附加动作字典构造，可用于从PDF文档、PDF页面、PDF表单字段或PDF注释的 附加动作字典获取/设置数据。

## 构造及析构函数说明

## ◆ AdditionalAction() [1/5]

com.foxit.sdk.pdf.actions.AdditionalAction.AdditionalAction | ( | PDFDoc | doc,
|  | PDFDictionary | pdf_dict
| ) |  | throws com.foxit.sdk.PDFException

构造函数，从PDF文档或PDF字典（如果有）。

参数

  [in] | doc | 有效的PDF文档对象。
  [in] | pdf_dict | 表示附加动作字典的PDF字典。 如果此参数为null，那意味着仅使用PDF文档构造附加动作对象。 如果此参数不为null，那意味着从此PDF字典构造附加动作对象， 该字典应已存在于指定的PDF文档中并表示附加动作字典。 默认值：null。

## ◆ AdditionalAction() [2/5]

com.foxit.sdk.pdf.actions.AdditionalAction.AdditionalAction | ( | PDFPage | page | ) | throws com.foxit.sdk.PDFException

构造函数，从PDF页面。

参数

  [in] | page | 有效的PDF页面对象。

## ◆ AdditionalAction() [3/5]

com.foxit.sdk.pdf.actions.AdditionalAction.AdditionalAction | ( | Field | field | ) | throws com.foxit.sdk.PDFException

构造函数，从PDF表单字段。

参数

  [in] | field | 有效的PDF表单字段。

## ◆ AdditionalAction() [4/5]

com.foxit.sdk.pdf.actions.AdditionalAction.AdditionalAction | ( | Annot | annot | ) | throws com.foxit.sdk.PDFException

构造函数，从PDF注释。

参数

  [in] | annot | 有效的PDF注释。目前，仅支持小部件和屏幕注释。 对于其他类型的注释，此函数将抛出异常 com.foxit.sdk.common.Constants.e_ErrUnsupported 。

## ◆ AdditionalAction() [5/5]

com.foxit.sdk.pdf.actions.AdditionalAction.AdditionalAction | ( | AdditionalAction | other | ) |

构造函数，使用另一个附加动作对象。

参数

  [in] | other | 另一个附加动作对象。

## 成员函数说明

## ◆ delete()

synchronized void com.foxit.sdk.pdf.actions.AdditionalAction.delete | ( |  | ) |

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

返回
  无。

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

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

## ◆ doJSAction()

boolean com.foxit.sdk.pdf.actions.AdditionalAction.doJSAction | ( | int | trigger | ) | throws com.foxit.sdk.PDFException

执行由触发器事件类型指定的JavaScript动作。

如果当前对象是用有效的PDF字典构造的，此函数将直接返回false 因为福昕PDF SDK无法知道附加动作字典与哪种对象关联。

参数

  [in] | trigger | 输入的触发器事件类型。它应该是： 如果当前附加动作是从PDF页面构造的，触发器值必须是 从com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerPageOpened 开始的值之一 （具有相同的前缀名称）。 如果当前附加动作是从PDF文档构造的，触发器值必须是 从com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerDocWillClose 开始的值之一 （具有相同的前缀名称）。 如果当前附加动作是从PDF表单字段构造的，触发器值必须是 从com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerFieldKeyStroke 开始的值之一 （具有相同的前缀名称）。 如果当前附加动作是从PDF注释构造的，触发器值必须是 从com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerAnnotCursorEnter 开始的值之一 （具有相同的前缀名称）。

返回
  true表示成功，而false表示失败或当前对象是从PDF字典构造的。

## ◆ getAction()

Action com.foxit.sdk.pdf.actions.AdditionalAction.getAction | ( | int | trigger | ) | throws com.foxit.sdk.PDFException

获取具有指定触发器事件类型的动作。

参数

  [in] | trigger | 输入的触发器事件类型。它应该是： 如果当前附加动作是从PDF字典构造的，触发器值可以是 枚举类TriggerEvent中定义的值之一。 如果当前附加动作是从PDF页面构造的，触发器值必须是 从com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerPageOpened 开始的值之一 （具有相同的前缀名称）。 如果当前附加动作是从PDF文档构造的，触发器值必须是 从com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerDocWillClose 开始的值之一 （具有相同的前缀名称）。 如果当前附加动作是从PDF表单字段构造的，触发器值必须是 从com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerFieldKeyStroke 开始的值之一 （具有相同的前缀名称）。 如果当前附加动作是从PDF注释构造的，触发器值必须是 从com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerAnnotCursorEnter 开始的值之一 （具有相同的前缀名称）。

返回
  动作对象。

## ◆ getDict()

PDFDictionary com.foxit.sdk.pdf.actions.AdditionalAction.getDict | ( |  | ) | throws com.foxit.sdk.PDFException

获取当前对象的PDF字典。

返回
  PDF字典。如果有任何错误，此函数将返回null。

## ◆ isEmpty()

boolean com.foxit.sdk.pdf.actions.AdditionalAction.isEmpty | ( |  | ) |

检查当前对象是否为空。

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

返回
  true表示当前对象为空，而false表示不为空。

## ◆ removeAction()

boolean com.foxit.sdk.pdf.actions.AdditionalAction.removeAction | ( | int | trigger | ) | throws com.foxit.sdk.PDFException

移除具有指定触发器事件类型的动作。

如果输入的触发器事件类型有效但没有动作时，此函数将直接返回true。

参数

  [in] | trigger | 输入的触发器事件类型。它应该是： 如果当前附加动作是从PDF字典构造的，触发器值可以是 枚举类TriggerEvent中定义的值之一。 如果当前附加动作是从PDF页面构造的，触发器值必须是 从com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerPageOpened 开始的值之一 （具有相同的前缀名称）。 如果当前附加动作是从PDF文档构造的，触发器值必须是 从com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerDocWillClose 开始的值之一 （具有相同的前缀名称）。 如果当前附加动作是从PDF表单字段构造的，触发器值必须是 从com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerFieldKeyStroke 开始的值之一 （具有相同的前缀名称）。 如果当前附加动作是从PDF注释构造的，触发器值必须是 从com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerAnnotCursorEnter 开始的值之一 （具有相同的前缀名称）。

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

## ◆ removeAllActions()

boolean com.foxit.sdk.pdf.actions.AdditionalAction.removeAllActions | ( |  | ) | throws com.foxit.sdk.PDFException

移除所有动作。

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

## ◆ setAction()

void com.foxit.sdk.pdf.actions.AdditionalAction.setAction | ( | int | trigger,
|  | Action | action
| ) |  | throws com.foxit.sdk.PDFException

为指定的触发器事件类型设置附加动作。

参数

  [in] | trigger | 输入的触发器事件类型。它应该是： 如果当前附加动作是从PDF字典构造的，触发器值可以是 枚举类TriggerEvent中定义的值之一。 如果当前附加动作是从PDF页面构造的，触发器值必须是 从com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerPageOpened 开始的值之一 （具有相同的前缀名称）。 如果当前附加动作是从PDF文档构造的，触发器值必须是 从com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerDocWillClose 开始的值之一 （具有相同的前缀名称）。 如果当前附加动作是从PDF表单字段构造的，触发器值必须是 从com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerFieldKeyStroke 开始的值之一 （具有相同的前缀名称）。 如果当前附加动作是从PDF注释构造的，触发器值必须是 从com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerAnnotCursorEnter 开始的值之一 （具有相同的前缀名称）。
  [in] | action | 要设置的动作对象。 如果当前附加动作是从PDF文档或PDF表单字段构造的，此动作的类型应该 是com.foxit.sdk.pdf.actions.Action.e_TypeJavaScript 。 如果当前附加动作是从PDF页面、PDF注释或PDF字典构造的， 请参考触发器事件的注释来检查是否只能使用指定类型的动作。 通常，支持以下类型作为新动作： com.foxit.sdk.pdf.actions.Action.e_TypeGoto , com.foxit.sdk.pdf.actions.Action.e_TypeURI , com.foxit.sdk.pdf.actions.Action.e_TypeJavaScript , com.foxit.sdk.pdf.actions.Action.e_TypeNamed , com.foxit.sdk.pdf.actions.Action.e_TypeGoToR , com.foxit.sdk.pdf.actions.Action.e_TypeGoToE , com.foxit.sdk.pdf.actions.Action.e_TypeSubmitForm , com.foxit.sdk.pdf.actions.Action.e_TypeResetForm , com.foxit.sdk.pdf.actions.Action.e_TypeHide , com.foxit.sdk.pdf.actions.Action.e_TypeLaunch , com.foxit.sdk.pdf.actions.Action.e_TypeImportData , com.foxit.sdk.pdf.actions.Action.e_TypeRendition 。

返回
  无。

## 类成员变量说明

## ◆ e_TriggerAnnotCursorEnter

final int com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerAnnotCursorEnter = 11
| static

触发当光标进入注释的活动区域时执行的动作。

这表示注释的附加动作字典中的"E"条目。 仅适用于从PDF注释构造的附加动作对象。

## ◆ e_TriggerAnnotCursorExit

final int com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerAnnotCursorExit = 12
| static

触发当光标离开注释的活动区域时执行的动作。

这表示注释的附加动作字典中的"X"条目。 仅适用于从PDF注释构造的附加动作对象。

## ◆ e_TriggerAnnotLoseInputFocus

final int com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerAnnotLoseInputFocus = 16
| static

（仅适用于小部件注释）触发当注释失去输入焦点时执行的动作。

这表示注释的附加动作字典中的"Bl"（大写B和小写L，代表"blurred"）条目。 仅适用于从小部件注释构造的附加动作对象。

## ◆ e_TriggerAnnotMouseButtonPressed

final int com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerAnnotMouseButtonPressed = 13
| static

触发当鼠标按钮在注释的活动区域内按下时执行的动作。

这表示注释的附加动作字典中的"D"（代表"Down"）条目。 仅适用于从PDF注释构造的附加动作对象。

## ◆ e_TriggerAnnotMouseButtonReleased

final int com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerAnnotMouseButtonReleased = 14
| static

触发当鼠标按钮在注释的活动区域内释放时执行的动作。

这表示注释的附加动作字典中的"U"（代表"Up"）条目。 仅适用于从PDF注释构造的附加动作对象。

## ◆ e_TriggerAnnotPageClosed

final int com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerAnnotPageClosed = 18
| static

触发当包含注释的页面关闭时执行的动作。

这表示注释的附加动作字典中的"PC"条目。 仅适用于从PDF注释构造的附加动作对象。 触发的动作在com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerPageClosed 的动作被触发后执行， 如果存在此类动作。

## ◆ e_TriggerAnnotPageInvisible

final int com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerAnnotPageInvisible = 20
| static

触发当包含注释的页面在查看器应用程序的用户界面中不再可见时执行的动作。

这表示注释的附加动作字典中的"PI"条目。 仅适用于从PDF注释构造的附加动作对象。

## ◆ e_TriggerAnnotPageOpened

final int com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerAnnotPageOpened = 17
| static

触发当包含注释的页面打开时执行的动作。

这表示注释的附加动作字典中的"PO"条目。 仅适用于从PDF注释构造的附加动作对象。 触发的动作在com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerPageOpened 的动作被触发后 以及PDF文档的打开动作（如果存在此类动作）之后执行。

## ◆ e_TriggerAnnotPageVisible

final int com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerAnnotPageVisible = 19
| static

触发当包含注释的页面在查看器应用程序的用户界面中变为可见时执行的动作。

这表示注释的附加动作字典中的"PV"条目。 仅适用于从PDF注释构造的附加动作对象。

## ◆ e_TriggerAnnotReceiveInputFocus

final int com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerAnnotReceiveInputFocus = 15
| static

（仅适用于小部件注释）触发当注释接收输入焦点时执行的动作。

这表示注释的附加动作字典中的"Fo"条目。 仅适用于从小部件注释构造的附加动作对象。

## ◆ e_TriggerDocPrinted

final int com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerDocPrinted = 6
| static

触发在打印文档后执行的JavaScript动作。

这表示文档目录的附加动作字典中的"DP"条目。 仅适用于从PDF文档构造的附加动作对象。

## ◆ e_TriggerDocSaved

final int com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerDocSaved = 4
| static

触发在保存文档后执行的JavaScript动作。

这表示文档目录的附加动作字典中的"DS"条目。 仅适用于从PDF文档构造的附加动作对象。

## ◆ e_TriggerDocWillClose

final int com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerDocWillClose = 2
| static

触发在关闭文档前执行的JavaScript动作。

这表示文档目录的附加动作字典中的"WC"条目。 仅适用于从PDF文档构造的附加动作对象。

## ◆ e_TriggerDocWillPrint

final int com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerDocWillPrint = 5
| static

触发在打印文档前执行的JavaScript动作。

这表示文档目录的附加动作字典中的"WP"条目。 仅适用于从PDF文档构造的附加动作对象。

## ◆ e_TriggerDocWillSave

final int com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerDocWillSave = 3
| static

触发在保存文档前执行的JavaScript动作。

这表示文档目录的附加动作字典中的"WS"条目。 仅适用于从PDF文档构造的附加动作对象。

## ◆ e_TriggerFieldKeyStroke

final int com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerFieldKeyStroke = 7
| static

触发当用户在文本字段或组合框中输入按键或修改可滚动列表框中的选择时执行的JavaScript动作。

这表示表单字段的附加动作字典中的"K"条目。 仅适用于从PDF表单字段构造的附加动作对象。
触发的动作可以检查按键的有效性并拒绝或修改它。

## ◆ e_TriggerFieldRecalculateValue

final int com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerFieldRecalculateValue = 10
| static

触发当另一个字段改变时重新计算此字段值的JavaScript动作。

这表示表单字段的附加动作字典中的"C"条目。 仅适用于从PDF表单字段构造的附加动作对象。
文档字段重新计算的顺序可以通过函数 interform.Form.getFieldsInCalculationOrder 获得。

## ◆ e_TriggerFieldValueChanged

final int com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerFieldValueChanged = 9
| static

触发当字段的值改变时执行的JavaScript动作。

这表示表单字段的附加动作字典中的"V"条目。 仅适用于从PDF表单字段构造的附加动作对象。
触发的动作可以检查新值的有效性。

## ◆ e_TriggerFieldWillFormat

final int com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerFieldWillFormat = 8
| static

触发在字段被格式化以显示其当前值之前执行的JavaScript动作。

这表示表单字段的附加动作字典中的"F"条目。 仅适用于从PDF表单字段构造的附加动作对象。
触发的动作可以在格式化前修改字段的值。

## ◆ e_TriggerPageClosed

final int com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerPageClosed = 1
| static

触发在页面关闭时执行的动作。

这表示页面对象的附加动作字典中的"C"条目。 仅适用于从PDF页面构造的附加动作对象。

## ◆ e_TriggerPageOpened

final int com.foxit.sdk.pdf.actions.AdditionalAction.e_TriggerPageOpened = 0
| static

触发在页面打开时执行的动作。

这表示页面对象的附加动作字典中的"O"条目。 仅适用于从PDF页面构造的附加动作对象。