Foxit PDF SDK

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

## Public 成员函数
| RemoteGotoAction (Action action)
| 构造函数，使用父类对象。 更多...
synchronized void | delete ()
| 直接清除C++相关资源。 更多...
Destination | getDestination () throws com.foxit.sdk.PDFException
| 获取目标信息。 更多...
String | getDestinationName () throws com.foxit.sdk.PDFException
| 获取在目标PDF文件中定义的目标名称。 更多...
FileSpec | getFileSpec () throws com.foxit.sdk.PDFException
| 获取指定目标文件的文件规范。 更多...
int | getNewWindowFlag () throws com.foxit.sdk.PDFException
| 获取用于决定是否在新窗口中打开目标文档的标志。 更多...
void | setDestination (Destination destination) throws com.foxit.sdk.PDFException
| 设置目标信息，用于指定在目标PDF文件中要跳转到的位置。 更多...
void | setDestinationName (String dest_name) throws com.foxit.sdk.PDFException
| 设置目标名称。 更多...
void | setFileSpec (FileSpec file_specification) throws com.foxit.sdk.PDFException
| 设置指定目标文件的文件规范。 更多...
void | setNewWindowFlag (int flag) throws com.foxit.sdk.PDFException
| 设置用于决定是否在新窗口中打开目标文档的标志。 更多...
Public 成员函数 继承自 com.foxit.sdk.pdf.actions.Action
| Action (Action action)
| 构造函数，使用另一个动作对象。 更多...
| Action (PDFDoc document, PDFDictionary action_dict)
| 构造函数，带参数。 更多...
PDFDictionary | getDict () throws com.foxit.sdk.PDFException
| 获取当前对象的PDF字典。 更多...
PDFDoc | getDocument () throws com.foxit.sdk.PDFException
| 获取当前动作所属的PDF文档。 更多...
Action | getSubAction (int index) throws com.foxit.sdk.PDFException
| 按索引获取子动作。 更多...
int | getSubActionCount () throws com.foxit.sdk.PDFException
| 获取子动作的数量。 更多...
int | getType () throws com.foxit.sdk.PDFException
| 获取动作类型。 更多...
void | insertSubAction (int index, Action sub_action) throws com.foxit.sdk.PDFException
| 在指定索引位置插入新的子动作。 更多...
boolean | isEmpty ()
| 检查当前对象是否为空。 更多...
void | removeAllSubActions () throws com.foxit.sdk.PDFException
| 移除所有子动作。 更多...
void | removeSubAction (int index) throws com.foxit.sdk.PDFException
| 移除指定索引的子动作。 更多...
void | setSubAction (int index, Action sub_action) throws com.foxit.sdk.PDFException
| 按索引设置子动作。 更多...

## 额外继承的成员函数
静态 Public 成员函数 继承自 com.foxit.sdk.pdf.actions.Action
static Action | create (PDFDoc document, int action_type) throws com.foxit.sdk.PDFException
| 为指定的动作类型创建新动作。 更多...
静态 Public 属性 继承自 com.foxit.sdk.pdf.actions.Action
static final int | e_NewWindowFlagFalse = 0
| "NewWindow"标志为false。
static final int | e_NewWindowFlagNone = 2
| 无"NewWindow"标志。
static final int | e_NewWindowFlagTrue = 1
| "NewWindow"标志为true。
static final int | e_TypeGoto = 1
| 动作类型：转到动作。
static final int | e_TypeGoTo3DView = 18
| 动作类型：转到3D视图动作。
static final int | e_TypeGoToE = 3
| 动作类型：嵌入转到动作。
static final int | e_TypeGoToR = 2
| 动作类型：远程转到动作。
static final int | e_TypeHide = 9
| 动作类型：隐藏动作。
static final int | e_TypeImportData = 13
| 动作类型：导入数据动作。
static final int | e_TypeJavaScript = 14
| 动作类型：JavaScript动作。
static final int | e_TypeLaunch = 4
| 动作类型：启动动作。
static final int | e_TypeMovie = 8
| 动作类型：电影动作。
static final int | e_TypeNamed = 10
| 动作类型：命名动作。
static final int | e_TypeRendition = 16
| 动作类型：演示动作。
static final int | e_TypeResetForm = 12
| 动作类型：重置表单动作。
static final int | e_TypeSetOCGState = 15
| 动作类型：设置OCG状态动作。
static final int | e_TypeSound = 7
| 动作类型：声音动作。
static final int | e_TypeSubmitForm = 11
| 动作类型：提交表单动作。
static final int | e_TypeThread = 5
| 动作类型：线程动作。
static final int | e_TypeTrans = 17
| 动作类型：过渡动作。
static final int | e_TypeUnknown = 0
| 动作类型：未知动作。
static final int | e_TypeURI = 6
| 动作类型：统一资源标识符(URI)动作。

## 详细描述

远程转到动作类似于普通转到动作，但跳转到另一个PDF文件中的目标 （非嵌入文件），而不是当前PDF文件（包含远程转到动作的文件）。
类com.foxit.sdk.pdf.actions.RemoteGotoAction 派生自Action ，提供用于 获取/设置远程转到动作数据的函数。 远程转到动作的目标信息可以表示为目标数组或目标名称：

- 如果目标信息是目标数组，Foxit PDF SDK使用目标对象来 表示它，可以使用RemoteGotoAction.getDestination 获取此值。
- 如果目标信息是目标名称，Foxit PDF SDK使用字符串来表示它， 可以使用RemoteGotoAction.getDestinationName 获取此值。 特别地，相关的目标数组在目标PDF文件中定义，而不是在当前PDF文件中。 用户可以使用类com.foxit.sdk.pdf.objects.PDFNameTree 中的函数从目标PDF文件检索实际的目标数组。

目标PDF文件和目标信息对于远程转到动作是必需的，因此用户应 确保通过RemoteGotoAction.setFileSpec 和 RemoteGotoAction.setDestination 或RemoteGotoAction.setDestinationName 设置这两个数据，特别是对于新的远程转到动作；否则，远程转到动作将是无用的。

参见
  Action

## 构造及析构函数说明

## ◆ RemoteGotoAction()

com.foxit.sdk.pdf.actions.RemoteGotoAction.RemoteGotoAction | ( | Action | action | ) |

构造函数，使用父类对象。

参数

  [in] | action | 父类对象。

## 成员函数说明

## ◆ delete()

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

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

返回
  无。

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

重载 com.foxit.sdk.pdf.actions.Action .

## ◆ getDestination()

Destination com.foxit.sdk.pdf.actions.RemoteGotoAction.getDestination | ( |  | ) | throws com.foxit.sdk.PDFException

获取目标信息。

对于远程转到动作，目标信息可以存储为目标对象 或目标名称：

- 如果是目标对象，函数RemoteGotoAction.getDestination 将 返回有效的目标对象。
- 如果是目标名称，函数RemoteGotoAction.getDestinationName 将 返回有效的字符串，目标名称将在目标PDF文件中定义。

如果返回的目标对象的函数Destination.isEmpty 的返回值 为true，且函数RemoteGotoAction.getDestinationName 返回空字符串，则表示远程转到动作没有任何目标信息。

返回
  目标对象。如果返回的目标对象的函数Destination.isEmpty 的返回值 为true，请尝试函数 RemoteGotoAction.getDestinationName 。

## ◆ getDestinationName()

String com.foxit.sdk.pdf.actions.RemoteGotoAction.getDestinationName | ( |  | ) | throws com.foxit.sdk.PDFException

获取在目标PDF文件中定义的目标名称。

对于远程转到动作，目标信息可以存储为目标对象 或目标名称：

- 如果是目标对象，函数RemoteGotoAction.getDestination 将 返回有效的目标对象。
- 如果是目标名称，函数RemoteGotoAction.getDestinationName 将 返回有效的字符串，目标名称将在目标PDF文件中定义。

如果返回的目标对象的函数Destination.isEmpty 的返回值 为true，且函数RemoteGotoAction.getDestinationName 返回空字符串，则表示远程转到动作没有任何目标信息。

返回
  目标名称。如果此函数返回空字符串，请尝试函数 RemoteGotoAction.getDestination 。

## ◆ getFileSpec()

FileSpec com.foxit.sdk.pdf.actions.RemoteGotoAction.getFileSpec | ( |  | ) | throws com.foxit.sdk.PDFException

获取指定目标文件的文件规范。

返回
  非嵌入的文件规范对象。

## ◆ getNewWindowFlag()

int com.foxit.sdk.pdf.actions.RemoteGotoAction.getNewWindowFlag | ( |  | ) | throws com.foxit.sdk.PDFException

获取用于决定是否在新窗口中打开目标文档的标志。

返回
  新窗口标志。将是以下值之一：
  - com.foxit.sdk.pdf.actions.Action.e_NewWindowFlagTrue 表示在新窗口中打开目标文档。
  - com.foxit.sdk.pdf.actions.Action.e_NewWindowFlagFalse 表示 目标文档在同一窗口中替换当前文档。
  - com.foxit.sdk.pdf.actions.Action.e_NewWindowFlagNone 表示 没有此类标志，查看器应用程序应根据当前用户首选项行为。

## ◆ setDestination()

void com.foxit.sdk.pdf.actions.RemoteGotoAction.setDestination | ( | Destination | destination | ) | throws com.foxit.sdk.PDFException

设置目标信息，用于指定在目标PDF文件中要跳转到的位置。

参数

  [in] | destination | 要设置的有效目标对象。

返回
  无。

## ◆ setDestinationName()

void com.foxit.sdk.pdf.actions.RemoteGotoAction.setDestinationName | ( | String | dest_name | ) | throws com.foxit.sdk.PDFException

设置目标名称。

目标名称应该已经在目标PDF文件的"Dests"名称树中。

参数

  [in] | dest_name | 要设置的目标名称。不应为空字符串。

返回
  无。

## ◆ setFileSpec()

void com.foxit.sdk.pdf.actions.RemoteGotoAction.setFileSpec | ( | FileSpec | file_specification | ) | throws com.foxit.sdk.PDFException

设置指定目标文件的文件规范。

参数

  [in] | file_specification | 要设置的有效文件规范对象。此对象应属于 与当前动作相同的PDF文件。它应该表示另一个PDF文件作为 目标文件，不应表示嵌入文件。

返回
  无。

## ◆ setNewWindowFlag()

void com.foxit.sdk.pdf.actions.RemoteGotoAction.setNewWindowFlag | ( | int | flag | ) | throws com.foxit.sdk.PDFException

设置用于决定是否在新窗口中打开目标文档的标志。

参数

  [in] | flag | 新窗口标志。应为以下值之一： com.foxit.sdk.pdf.actions.Action.e_NewWindowFlagTrue 表示 在新窗口中打开目标文档。 com.foxit.sdk.pdf.actions.Action.e_NewWindowFlagFalse 表示 目标文档在同一窗口中替换当前文档。 com.foxit.sdk.pdf.actions.Action.e_NewWindowFlagNone 表示 不需要此类标志，查看器应用程序应根据 当前用户首选项行为。

返回
  无。