Foxit PDF SDK

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

## Public 成员函数
def | AdditionalAction (annot)
| 构造函数，从PDF注释。 更多...
def | AdditionalAction (field)
| 构造函数，从PDF表单字段。 更多...
def | AdditionalAction (other)
| 构造函数，使用另一个附加动作对象。 更多...
def | AdditionalAction (page)
| 构造函数，从PDF页面。 更多...
def | DoJSAction (trigger)
| 执行由触发器事件类型指定的JavaScript动作。 更多...
def | GetAction (trigger)
| 获取具有指定触发器事件类型的动作。 更多...
def | GetDict ()
| 获取当前对象的PDF字典。 更多...
def | IsEmpty ()
| 检查当前对象是否为空。 更多...
def | RemoveAction (trigger)
| 移除具有指定触发器事件类型的动作。 更多...
def | RemoveAllActions ()
| 移除所有动作。 更多...
def | SetAction (trigger, action)
| 为指定的触发器事件类型设置附加动作。 更多...

## 静态 Public 属性
| e_TriggerAnnotCursorEnter = _fsdk.AdditionalAction_e_TriggerAnnotCursorEnter
| 触发当光标进入注释的活动区域时执行的动作。 更多...
| e_TriggerAnnotCursorExit = _fsdk.AdditionalAction_e_TriggerAnnotCursorExit
| 触发当光标离开注释的活动区域时执行的动作。 更多...
| e_TriggerAnnotLoseInputFocus = _fsdk.AdditionalAction_e_TriggerAnnotLoseInputFocus
| （仅适用于小部件注释）触发当注释失去输入焦点时执行的动作。 更多...
| e_TriggerAnnotMouseButtonPressed = _fsdk.AdditionalAction_e_TriggerAnnotMouseButtonPressed
| 触发当鼠标按钮在注释的活动区域内按下时执行的动作。 更多...
| e_TriggerAnnotMouseButtonReleased = _fsdk.AdditionalAction_e_TriggerAnnotMouseButtonReleased
| 触发当鼠标按钮在注释的活动区域内释放时执行的动作。 更多...
| e_TriggerAnnotPageClosed = _fsdk.AdditionalAction_e_TriggerAnnotPageClosed
| 触发当包含注释的页面关闭时执行的动作。 更多...
| e_TriggerAnnotPageInvisible = _fsdk.AdditionalAction_e_TriggerAnnotPageInvisible
| 触发当包含注释的页面在查看器应用程序的用户界面中不再可见时执行的动作。 更多...
| e_TriggerAnnotPageOpened = _fsdk.AdditionalAction_e_TriggerAnnotPageOpened
| 触发当包含注释的页面打开时执行的动作。 更多...
| e_TriggerAnnotPageVisible = _fsdk.AdditionalAction_e_TriggerAnnotPageVisible
| 触发当包含注释的页面在查看器应用程序的用户界面中变为可见时执行的动作。 更多...
| e_TriggerAnnotReceiveInputFocus = _fsdk.AdditionalAction_e_TriggerAnnotReceiveInputFocus
| （仅适用于小部件注释）触发当注释接收输入焦点时执行的动作。 更多...
| e_TriggerDocPrinted = _fsdk.AdditionalAction_e_TriggerDocPrinted
| 触发在打印文档后执行的JavaScript动作。 更多...
| e_TriggerDocSaved = _fsdk.AdditionalAction_e_TriggerDocSaved
| 触发在保存文档后执行的JavaScript动作。 更多...
| e_TriggerDocWillClose = _fsdk.AdditionalAction_e_TriggerDocWillClose
| 触发在关闭文档前执行的JavaScript动作。 更多...
| e_TriggerDocWillPrint = _fsdk.AdditionalAction_e_TriggerDocWillPrint
| 触发在打印文档前执行的JavaScript动作。 更多...
| e_TriggerDocWillSave = _fsdk.AdditionalAction_e_TriggerDocWillSave
| 触发在保存文档前执行的JavaScript动作。 更多...
| e_TriggerFieldKeyStroke = _fsdk.AdditionalAction_e_TriggerFieldKeyStroke
| 触发当用户在文本字段或组合框中输入按键或修改可滚动列表框中的选择时执行的JavaScript动作。 更多...
| e_TriggerFieldRecalculateValue = _fsdk.AdditionalAction_e_TriggerFieldRecalculateValue
| 触发当另一个字段改变时重新计算此字段值的JavaScript动作。 更多...
| e_TriggerFieldValueChanged = _fsdk.AdditionalAction_e_TriggerFieldValueChanged
| 触发当字段的值改变时执行的JavaScript动作。 更多...
| e_TriggerFieldWillFormat = _fsdk.AdditionalAction_e_TriggerFieldWillFormat
| 触发在字段被格式化以显示其当前值之前执行的JavaScript动作。 更多...
| e_TriggerPageClosed = _fsdk.AdditionalAction_e_TriggerPageClosed
| 触发在页面关闭时执行的动作。 更多...
| e_TriggerPageOpened = _fsdk.AdditionalAction_e_TriggerPageOpened
| 触发在页面打开时执行的动作。 更多...

## 详细描述

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

## 构造及析构函数说明

## ◆ AdditionalAction() [1/4]

def FoxitPDFSDKPython3.AdditionalAction.AdditionalAction | ( |  | page | ) |

构造函数，从PDF页面。

参数

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

## ◆ AdditionalAction() [2/4]

def FoxitPDFSDKPython3.AdditionalAction.AdditionalAction | ( |  | field | ) |

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

参数

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

## ◆ AdditionalAction() [3/4]

def FoxitPDFSDKPython3.AdditionalAction.AdditionalAction | ( |  | annot | ) |

构造函数，从PDF注释。

参数

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

## ◆ AdditionalAction() [4/4]

def FoxitPDFSDKPython3.AdditionalAction.AdditionalAction | ( |  | other | ) |

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

参数

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

## 成员函数说明

## ◆ DoJSAction()

def FoxitPDFSDKPython3.AdditionalAction.DoJSAction | ( |  | trigger | ) |

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

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

参数

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

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

## ◆ GetAction()

def FoxitPDFSDKPython3.AdditionalAction.GetAction | ( |  | trigger | ) |

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

参数

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

返回
  动作对象。

## ◆ GetDict()

def FoxitPDFSDKPython3.AdditionalAction.GetDict | ( |  | ) |

获取当前对象的PDF字典。

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

## ◆ IsEmpty()

def FoxitPDFSDKPython3.AdditionalAction.IsEmpty | ( |  | ) |

检查当前对象是否为空。

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

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

## ◆ RemoveAction()

def FoxitPDFSDKPython3.AdditionalAction.RemoveAction | ( |  | trigger | ) |

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

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

参数

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

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

## ◆ RemoveAllActions()

def FoxitPDFSDKPython3.AdditionalAction.RemoveAllActions | ( |  | ) |

移除所有动作。

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

## ◆ SetAction()

def FoxitPDFSDKPython3.AdditionalAction.SetAction | ( |  | trigger,
|  |  | action
| ) |  |

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

参数

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

返回
  无。

## 类成员变量说明

## ◆ e_TriggerAnnotCursorEnter

FoxitPDFSDKPython3.AdditionalAction.e_TriggerAnnotCursorEnter = _fsdk.AdditionalAction_e_TriggerAnnotCursorEnter
| static

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

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

## ◆ e_TriggerAnnotCursorExit

FoxitPDFSDKPython3.AdditionalAction.e_TriggerAnnotCursorExit = _fsdk.AdditionalAction_e_TriggerAnnotCursorExit
| static

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

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

## ◆ e_TriggerAnnotLoseInputFocus

FoxitPDFSDKPython3.AdditionalAction.e_TriggerAnnotLoseInputFocus = _fsdk.AdditionalAction_e_TriggerAnnotLoseInputFocus
| static

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

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

## ◆ e_TriggerAnnotMouseButtonPressed

FoxitPDFSDKPython3.AdditionalAction.e_TriggerAnnotMouseButtonPressed = _fsdk.AdditionalAction_e_TriggerAnnotMouseButtonPressed
| static

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

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

## ◆ e_TriggerAnnotMouseButtonReleased

FoxitPDFSDKPython3.AdditionalAction.e_TriggerAnnotMouseButtonReleased = _fsdk.AdditionalAction_e_TriggerAnnotMouseButtonReleased
| static

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

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

## ◆ e_TriggerAnnotPageClosed

FoxitPDFSDKPython3.AdditionalAction.e_TriggerAnnotPageClosed = _fsdk.AdditionalAction_e_TriggerAnnotPageClosed
| static

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

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

## ◆ e_TriggerAnnotPageInvisible

FoxitPDFSDKPython3.AdditionalAction.e_TriggerAnnotPageInvisible = _fsdk.AdditionalAction_e_TriggerAnnotPageInvisible
| static

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

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

## ◆ e_TriggerAnnotPageOpened

FoxitPDFSDKPython3.AdditionalAction.e_TriggerAnnotPageOpened = _fsdk.AdditionalAction_e_TriggerAnnotPageOpened
| static

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

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

## ◆ e_TriggerAnnotPageVisible

FoxitPDFSDKPython3.AdditionalAction.e_TriggerAnnotPageVisible = _fsdk.AdditionalAction_e_TriggerAnnotPageVisible
| static

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

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

## ◆ e_TriggerAnnotReceiveInputFocus

FoxitPDFSDKPython3.AdditionalAction.e_TriggerAnnotReceiveInputFocus = _fsdk.AdditionalAction_e_TriggerAnnotReceiveInputFocus
| static

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

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

## ◆ e_TriggerDocPrinted

FoxitPDFSDKPython3.AdditionalAction.e_TriggerDocPrinted = _fsdk.AdditionalAction_e_TriggerDocPrinted
| static

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

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

## ◆ e_TriggerDocSaved

FoxitPDFSDKPython3.AdditionalAction.e_TriggerDocSaved = _fsdk.AdditionalAction_e_TriggerDocSaved
| static

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

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

## ◆ e_TriggerDocWillClose

FoxitPDFSDKPython3.AdditionalAction.e_TriggerDocWillClose = _fsdk.AdditionalAction_e_TriggerDocWillClose
| static

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

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

## ◆ e_TriggerDocWillPrint

FoxitPDFSDKPython3.AdditionalAction.e_TriggerDocWillPrint = _fsdk.AdditionalAction_e_TriggerDocWillPrint
| static

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

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

## ◆ e_TriggerDocWillSave

FoxitPDFSDKPython3.AdditionalAction.e_TriggerDocWillSave = _fsdk.AdditionalAction_e_TriggerDocWillSave
| static

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

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

## ◆ e_TriggerFieldKeyStroke

FoxitPDFSDKPython3.AdditionalAction.e_TriggerFieldKeyStroke = _fsdk.AdditionalAction_e_TriggerFieldKeyStroke
| static

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

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

## ◆ e_TriggerFieldRecalculateValue

FoxitPDFSDKPython3.AdditionalAction.e_TriggerFieldRecalculateValue = _fsdk.AdditionalAction_e_TriggerFieldRecalculateValue
| static

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

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

## ◆ e_TriggerFieldValueChanged

FoxitPDFSDKPython3.AdditionalAction.e_TriggerFieldValueChanged = _fsdk.AdditionalAction_e_TriggerFieldValueChanged
| static

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

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

## ◆ e_TriggerFieldWillFormat

FoxitPDFSDKPython3.AdditionalAction.e_TriggerFieldWillFormat = _fsdk.AdditionalAction_e_TriggerFieldWillFormat
| static

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

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

## ◆ e_TriggerPageClosed

FoxitPDFSDKPython3.AdditionalAction.e_TriggerPageClosed = _fsdk.AdditionalAction_e_TriggerPageClosed
| static

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

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

## ◆ e_TriggerPageOpened

FoxitPDFSDKPython3.AdditionalAction.e_TriggerPageOpened = _fsdk.AdditionalAction_e_TriggerPageOpened
| static

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

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