Foxit PDF SDK

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

## Public 成员函数
| Rendition (PDFDoc pdf_doc, PDFDictionary rendition_dict) throws com.foxit.sdk.PDFException
| 带参数的构造函数。 更多...
| Rendition (Rendition other)
| 使用另一个演示对象的构造函数。 更多...
int | addMediaPlayer (int type, MediaPlayer player) throws com.foxit.sdk.PDFException
| 为指定类型添加媒体播放器对象。 更多...
synchronized void | delete ()
| 直接清除C++相关资源。 更多...
void | enableAutoPlay (boolean is_auto_play, int opt_type) throws com.foxit.sdk.PDFException
| 设置标志以决定媒体激活时是否应自动播放。 更多...
void | enableControlBarVisible (boolean is_visible, int opt_type) throws com.foxit.sdk.PDFException
| 设置控制栏可见性标志。 更多...
void | enableFloatingWindowCloseButton (boolean is_visible, int opt_type) throws com.foxit.sdk.PDFException
| 设置标志以指定浮动窗口是否应包含允许用户 关闭浮动窗口的用户界面元素。 更多...
void | enableFloatingWindowTitleBar (boolean is_visible, int opt_type) throws com.foxit.sdk.PDFException
| 设置标志以指定浮动窗口是否应有标题栏。 更多...
long | getBackgroundColor () throws com.foxit.sdk.PDFException
| 获取媒体正在播放的矩形的背景颜色。 更多...
float | getBackgroundOpacity () throws com.foxit.sdk.PDFException
| 获取背景不透明度。（对于全屏和隐藏窗口将被忽略） 更多...
PDFDictionary | getDict () throws com.foxit.sdk.PDFException
| 获取当前对象的PDF字典。 更多...
int | getDuration () throws com.foxit.sdk.PDFException
| 获取内在持续时间。 更多...
int | getFitStyle () throws com.foxit.sdk.PDFException
| 获取适配样式。 更多...
int | getFloatingWindowHeight () throws com.foxit.sdk.PDFException
| 获取浮动窗口的高度，以像素为单位。 更多...
int | getFloatingWindowOffscreenEvent () throws com.foxit.sdk.PDFException
| 获取事件类型，指定如果浮动窗口完全或部分位于屏幕外 （即在任何物理监视器上都不可见）时应发生什么。 更多...
int | getFloatingWindowPosition () throws com.foxit.sdk.PDFException
| 获取浮动窗口应相对于相关窗口定位的位置。 更多...
int | getFloatingWindowRelatedWindowType () throws com.foxit.sdk.PDFException
| 获取窗口相对类型。 更多...
int | getFloatingWindowResizeType () throws com.foxit.sdk.PDFException
| 获取调整大小类型，指定浮动窗口是否可以由用户调整大小。 更多...
WStringArray | getFloatingWindowTitles () throws com.foxit.sdk.PDFException
| 获取多语言文本数组，提供要在浮动窗口标题栏上显示的文本。 更多...
int | getFloatingWindowWidth () throws com.foxit.sdk.PDFException
| 获取浮动窗口的宽度，以像素为单位。 更多...
String | getMediaBaseURL () throws com.foxit.sdk.PDFException
| 获取基础URL。 更多...
String | getMediaClipContentType () throws com.foxit.sdk.PDFException
| 获取媒体数据的内容类型（MIME类型）。 更多...
FileSpec | getMediaClipFile () throws com.foxit.sdk.PDFException
| 获取实际媒体数据的文件规范。 更多...
String | getMediaClipName () throws com.foxit.sdk.PDFException
| 获取媒体剪辑的名称，用于用户界面。 更多...
WStringArray | getMediaDescriptions () throws com.foxit.sdk.PDFException
| 获取多语言文本数组，在无法播放媒体剪辑数据时 提供替代文本描述。 更多...
MediaPlayer | getMediaPlayer (int type, int index) throws com.foxit.sdk.PDFException
| 根据索引获取指定类型的媒体播放器对象。 更多...
int | getMediaPlayerCount (int type) throws com.foxit.sdk.PDFException
| 获取指定类型的媒体播放器对象数量。 更多...
int | getMonitorSpecifier () throws com.foxit.sdk.PDFException
| 获取监视器指定类型值。 更多...
int | getPermission () throws com.foxit.sdk.PDFException
| 获取媒体权限。 更多...
String | getRenditionName () throws com.foxit.sdk.PDFException
| 获取名称。 更多...
int | getRepeatCount () throws com.foxit.sdk.PDFException
| 获取重复计数，类似于SMIL的repeatCount属性。 更多...
int | getVolume () throws com.foxit.sdk.PDFException
| 获取音量，以录制音量级别的百分比指定所需的音量级别。 更多...
int | getWindowType () throws com.foxit.sdk.PDFException
| 获取媒体应播放的窗口类型。 更多...
boolean | hasFloatingWindowCloseButton () throws com.foxit.sdk.PDFException
| 检查浮动窗口是否应包含允许用户 关闭浮动窗口的用户界面元素。 更多...
boolean | hasFloatingWindowTitleBar () throws com.foxit.sdk.PDFException
| 检查浮动窗口是否应有标题栏。 更多...
boolean | hasMediaClip () throws com.foxit.sdk.PDFException
| 检查当前演示对象是否包含媒体剪辑。 更多...
boolean | isAutoPlay () throws com.foxit.sdk.PDFException
| 检查媒体激活时是否应自动播放。 更多...
boolean | isControlBarVisible () throws com.foxit.sdk.PDFException
| 检查播放时是否显示播放器特定的控制器用户界面 （例如，播放/暂停/停止控件）。 更多...
boolean | isEmpty ()
| 检查当前对象是否为空。 更多...
void | removeMediaPlayer (int type, MediaPlayer player) throws com.foxit.sdk.PDFException
| 删除指定类型的媒体播放器对象。 更多...
void | setBackgroundColor (long color, int opt_type) throws com.foxit.sdk.PDFException
| 设置媒体正在播放的矩形的背景颜色。 更多...
void | setBackgroundOpacity (float opacity, int opt_type) throws com.foxit.sdk.PDFException
| 设置背景不透明度。（对于全屏和隐藏窗口将被忽略） 更多...
void | setDuration (int duration, int opt_type) throws com.foxit.sdk.PDFException
| 设置内在持续时间。 更多...
void | setFitStyle (int fit_style, int opt_type) throws com.foxit.sdk.PDFException
| 设置适配样式。 更多...
void | setFloatingWindowOffscreenEvent (int offscreen_event, int opt_type) throws com.foxit.sdk.PDFException
| 设置事件类型，指定如果浮动窗口完全或部分位于屏幕外 （即在任何物理监视器上都不可见）时应发生什么。 更多...
void | setFloatingWindowPosition (int position, int opt_type) throws com.foxit.sdk.PDFException
| 设置浮动窗口应相对于相关窗口定位的位置。 更多...
void | setFloatingWindowRelatedWindowType (int window_type, int opt_type) throws com.foxit.sdk.PDFException
| 设置窗口相对类型。 更多...
void | setFloatingWindowResizeType (int resize_type, int opt_type) throws com.foxit.sdk.PDFException
| 设置调整大小类型，指定浮动窗口是否可以由用户调整大小。 更多...
void | setFloatingWindowSize (int width, int height, int opt_type) throws com.foxit.sdk.PDFException
| 设置浮动窗口的大小，以像素为单位。 更多...
void | setFloatingWindowTitles (WStringArray titles, int opt_type) throws com.foxit.sdk.PDFException
| 设置多语言文本数组，提供要在浮动窗口标题栏上显示的文本。 更多...
void | setMediaBaseURL (String base_url, int opt_type) throws com.foxit.sdk.PDFException
| 设置基础URL。 更多...
void | setMediaClipContentType (String content_type) throws com.foxit.sdk.PDFException
| 设置媒体数据的内容类型（MIME类型）。 更多...
void | setMediaClipFile (FileSpec file_specification) throws com.foxit.sdk.PDFException
| 设置实际媒体数据的文件规范。 更多...
void | setMediaClipName (String name) throws com.foxit.sdk.PDFException
| 设置媒体剪辑的名称，用于用户界面。 更多...
void | setMediaDescriptions (WStringArray description_array) throws com.foxit.sdk.PDFException
| 设置多语言文本数组，在无法播放媒体剪辑数据时 提供替代文本描述。 更多...
void | setMonitorSpecifier (int monitor_specifier, int opt_type) throws com.foxit.sdk.PDFException
| 设置监视器指定类型值。 更多...
void | setPermission (int permission) throws com.foxit.sdk.PDFException
| 设置媒体权限。 更多...
void | setRenditionName (String name) throws com.foxit.sdk.PDFException
| 设置名称。 更多...
void | setRepeatCount (int count, int opt_type) throws com.foxit.sdk.PDFException
| 设置重复计数，类似于SMIL的repeatCount属性。 更多...
void | setVolume (int volume, int opt_type) throws com.foxit.sdk.PDFException
| 设置音量，以录制音量级别的百分比指定所需的音量级别。 更多...
void | setWindowType (int window_type, int opt_type) throws com.foxit.sdk.PDFException
| 设置媒体应播放的窗口类型。 更多...

## 静态 Public 属性
static final int | e_FloatingWindowOffscreenEventMoveResize = 1
| 移动或调整大小
static final int | e_FloatingWindowOffscreenEventNone = 0
| 什么都不做
static final int | e_FloatingWindowOffscreenEventNonViable = 2
| 认为对象不可行
static final int | e_FloatingWindowRelatedWindowApplication = 1
| 应用程序窗口
static final int | e_FloatingWindowRelatedWindowDocument = 0
| 文档窗口
static final int | e_FloatingWindowRelatedWindowFullDesktop = 2
| 完整的虚拟桌面
static final int | e_FloatingWindowRelatedWindowMonitor = 3
| 依赖于监视器指定。
static final int | e_FloatingWindowResizeTypeAnyway = 2
| 可以在不保持宽高比的情况下调整大小
static final int | e_FloatingWindowResizeTypeAspectRatio = 1
| 只有在保持宽高比的情况下才可以调整大小
static final int | e_FloatingWindowResizeTypeNo = 0
| 不能调整大小
static final int | e_MediaOptionBestEffort = 1
| 在此类型中定义的选项只需要在"尽力而为"的意义上被遵守。
static final int | e_MediaOptionMustBeHonored = 0
| 在此类型中定义的选项必须被遵守，演示对象才被认为是可行的。
static final int | e_MediaPermTempAccess = 2
| 只有当文档权限允许内容提取（包括用于辅助功能目的）时才允许。
static final int | e_MediaPermTempAlways = 3
| 总是允许。
static final int | e_MediaPermTempExtract = 1
| 只有当文档权限允许内容提取时才允许。
static final int | e_MediaPermTempNever = 0
| 从不允许。
static final int | e_MediaPlayerAvailable = 1
| 此类型中的任何播放器都可以用于播放相关的媒体剪辑。
static final int | e_MediaPlayerFitStyleDefault = 5
| 使用播放器的默认设置（作者没有偏好）。
static final int | e_MediaPlayerFitStyleFill = 2
| 媒体的宽度和高度独立缩放，使得媒体和播放矩形相同； 宽高比不一定保持。与SMIL的fit属性的"fill"值相同。
static final int | e_MediaPlayerFitStyleHidden = 4
| 媒体不缩放。只显示媒体矩形与播放矩形 相交的部分。与SMIL的fit属性的"hidden"值相同。
static final int | e_MediaPlayerFitStyleMeet = 0
| 在保持宽高比的同时缩放媒体的宽度和高度，使得 媒体和播放矩形具有最大可能的交集，同时仍然 显示所有媒体内容。与SMIL的fit属性的"meet"值相同。
static final int | e_MediaPlayerFitStyleScroll = 3
| 媒体不缩放。如果媒体矩形比播放矩形更宽或更高， 则提供滚动用户界面。与SMIL的fit属性的"scroll"值相同。
static final int | e_MediaPlayerFitStyleSlice = 1
| 在保持宽高比的同时缩放媒体的宽度和高度，使得 播放矩形完全填满，并且不适合 播放矩形内的媒体内容量最小化。与SMIL的fit属性的"slice"值相同。
static final int | e_MediaPlayerMustUsed = 0
| 此类型中的播放器之一必须用于播放相关的媒体剪辑。
static final int | e_MediaPlayerNotUsed = 2
| 此类型中的播放器不得用于播放相关的媒体剪辑。
static final int | e_MonitorSpecifierGreatestArea = 4
| 具有最大面积的监视器（以像素平方为单位）
static final int | e_MonitorSpecifierGreatestColorDepth = 3
| 具有最大颜色深度的监视器
static final int | e_MonitorSpecifierGreatestHeight = 5
| 具有最大高度的监视器（以像素为单位）
static final int | e_MonitorSpecifierGreatestWidth = 6
| 具有最大宽度的监视器（以像素为单位）
static final int | e_MonitorSpecifierLargest = 0
| 包含文档窗口最大部分的监视器
static final int | e_MonitorSpecifierPrimary = 2
| 主监视器。如果没有监视器被认为是主要的，使用情况0
static final int | e_MonitorSpecifierSmallest = 1
| 包含文档窗口最小部分的监视器
static final int | e_WindowTypeAnnotRect = 3
| 窗口类型：与演示对象关联的屏幕注释所占据的矩形。
static final int | e_WindowTypeFloating = 0
| 窗口类型：浮动窗口
static final int | e_WindowTypeFullScreen = 1
| 窗口类型：遮挡所有其他窗口的全屏窗口
static final int | e_WindowTypeHidden = 2
| 窗口类型：隐藏窗口

## 详细描述

演示对象用作媒体对象，指定播放什么、如何播放以及在哪里播放。 （更多详细信息，请参考 <PDF Reference 1.7> P758 Section "9.1.2 Renditions", P762 "Media Renditions"）

## 构造及析构函数说明

## ◆ Rendition() [1/2]

com.foxit.sdk.pdf.Rendition.Rendition | ( | PDFDoc | pdf_doc,
|  | PDFDictionary | rendition_dict
| ) |  | throws com.foxit.sdk.PDFException

带参数的构造函数。

参数

  [in] | pdf_doc | 有效的PDF文档对象。
  [in] | rendition_dict | 参数 pdf_doc 表示的PDF文档中演示对象的PDF字典。 如果这是 null，意味着在参数 pdf_obj 表示的PDF文档中 构造一个新的演示对象。 默认值：null。

## ◆ Rendition() [2/2]

com.foxit.sdk.pdf.Rendition.Rendition | ( | Rendition | other | ) |

使用另一个演示对象的构造函数。

参数

  [in] | other | 另一个演示对象。

## 成员函数说明

## ◆ addMediaPlayer()

int com.foxit.sdk.pdf.Rendition.addMediaPlayer | ( | int | type,
|  | MediaPlayer | player
| ) |  | throws com.foxit.sdk.PDFException

为指定类型添加媒体播放器对象。

通常，媒体播放器对象应该只添加到具有指定媒体播放器类型的演示对象中。 不建议用户将相同的媒体播放器对象添加到不同的演示或 一个演示的不同媒体播放器类型中；否则可能会发生意外问题（如崩溃）。 如果用户不想构造另一个媒体播放器并设置相同的值，用户可以克隆 原始媒体播放器对象的字典，并使用克隆的字典 直接构造另一个媒体播放器。

参数

  [in] | type | 媒体播放器类型。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaPlayerMustUsed 开始的值， 这应该是这些值中的一个。
  [in] | player | 要为指定类型添加的媒体播放器对象。如果媒体播放器已经为 指定类型存在，此函数将返回媒体播放器的索引。

返回
  输入媒体播放器的索引。

## ◆ delete()

synchronized void com.foxit.sdk.pdf.Rendition.delete | ( |  | ) |

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

返回
  无。

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

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

## ◆ enableAutoPlay()

void com.foxit.sdk.pdf.Rendition.enableAutoPlay | ( | boolean | is_auto_play,
|  | int | opt_type
| ) |  | throws com.foxit.sdk.PDFException

设置标志以决定媒体激活时是否应自动播放。

参数

  [in] | is_auto_play | true 表示媒体激活时应自动播放， false 表示媒体激活时应初始暂停 （例如，显示第一帧）。仅与可能暂停的媒体相关。
  [in] | opt_type | 媒体选项类型。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaOptionMustBeHonored 开始的值，这应该是这些值中的一个。 默认值：com.foxit.sdk.pdf.Rendition.e_MediaOptionBestEffort 。

返回
  无。

## ◆ enableControlBarVisible()

void com.foxit.sdk.pdf.Rendition.enableControlBarVisible | ( | boolean | is_visible,
|  | int | opt_type
| ) |  | throws com.foxit.sdk.PDFException

设置控制栏可见性标志。

控制栏可见性标志用于决定播放时是否显示播放器特定的控制器用户界面 （例如，播放/暂停/停止控件）。

参数

  [in] | is_visible | true 表示显示播放器特定的控制器用户界面， false 表示不显示此类用户界面。
  [in] | opt_type | 媒体选项类型。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaOptionMustBeHonored 开始的值，这应该是这些值中的一个。 默认值：com.foxit.sdk.pdf.Rendition.e_MediaOptionBestEffort 。

返回
  无。

## ◆ enableFloatingWindowCloseButton()

void com.foxit.sdk.pdf.Rendition.enableFloatingWindowCloseButton | ( | boolean | is_visible,
|  | int | opt_type
| ) |  | throws com.foxit.sdk.PDFException

设置标志以指定浮动窗口是否应包含允许用户 关闭浮动窗口的用户界面元素。

此属性仅在窗口类型为 com.foxit.sdk.pdf.Rendition.e_WindowTypeFloating 时有用。

参数

  [in] | is_visible | true 表示浮动窗口应包含允许用户 关闭浮动窗口的用户界面元素，false 表示 浮动窗口不需要包含此类用户界面元素。
  [in] | opt_type | 媒体选项类型。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaOptionMustBeHonored 开始的值，这应该是这些值中的一个。 默认值：com.foxit.sdk.pdf.Rendition.e_MediaOptionBestEffort 。

返回
  无。

## ◆ enableFloatingWindowTitleBar()

void com.foxit.sdk.pdf.Rendition.enableFloatingWindowTitleBar | ( | boolean | is_visible,
|  | int | opt_type
| ) |  | throws com.foxit.sdk.PDFException

设置标志以指定浮动窗口是否应有标题栏。

此属性仅在窗口类型为 com.foxit.sdk.pdf.Rendition.e_WindowTypeFloating 时有用。

参数

  [in] | is_visible | true 表示浮动窗口应有标题栏，false 表示 浮动窗口不需要有标题栏。
  [in] | opt_type | 媒体选项类型。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaOptionMustBeHonored 开始的值，这应该是这些值中的一个。 默认值：com.foxit.sdk.pdf.Rendition.e_MediaOptionBestEffort 。

返回
  无。

## ◆ getBackgroundColor()

long com.foxit.sdk.pdf.Rendition.getBackgroundColor | ( |  | ) | throws com.foxit.sdk.PDFException

获取媒体正在播放的矩形的背景颜色。

返回
  背景颜色。格式：0xRRGGBB。返回值 0xFFFFFF 也可能意味着演示对象中 未定义此属性的值。

## ◆ getBackgroundOpacity()

float com.foxit.sdk.pdf.Rendition.getBackgroundOpacity | ( |  | ) | throws com.foxit.sdk.PDFException

获取背景不透明度。（对于全屏和隐藏窗口将被忽略）

返回
  背景不透明度。有效范围：0.0 到 1.0。 0.0 表示完全透明，1.0 表示完全不透明。 如果演示对象中未定义此属性的值， 默认返回 1.0。

## ◆ getDict()

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

获取当前对象的PDF字典。

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

## ◆ getDuration()

int com.foxit.sdk.pdf.Rendition.getDuration | ( |  | ) | throws com.foxit.sdk.PDFException

获取内在持续时间。

返回
  内在持续时间值。可能是：
  - -2：使用内在持续时间；
  - -1：无限持续时间；
  - >= 0：显式持续时间。
  如果演示对象中未定义此属性的值，默认返回 -2。

## ◆ getFitStyle()

int com.foxit.sdk.pdf.Rendition.getFitStyle | ( |  | ) | throws com.foxit.sdk.PDFException

获取适配样式。

适配样式（方式）指定播放器应如何处理与其播放矩形不完全匹配的 视觉媒体类型。

返回
  适配样式值。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaPlayerFitStyleMeet 开始的值， 这将是这些值中的一个。如果演示对象中未定义此属性的值， 默认返回 com.foxit.sdk.pdf.Rendition.e_MediaPlayerFitStyleDefault 。

## ◆ getFloatingWindowHeight()

int com.foxit.sdk.pdf.Rendition.getFloatingWindowHeight | ( |  | ) | throws com.foxit.sdk.PDFException

获取浮动窗口的高度，以像素为单位。

当窗口类型为 com.foxit.sdk.pdf.Rendition.e_WindowTypeFloating 时，此属性是必需的。

返回
  浮动窗口的高度，以像素为单位。

## ◆ getFloatingWindowOffscreenEvent()

int com.foxit.sdk.pdf.Rendition.getFloatingWindowOffscreenEvent | ( |  | ) | throws com.foxit.sdk.PDFException

获取事件类型，指定如果浮动窗口完全或部分位于屏幕外 （即在任何物理监视器上都不可见）时应发生什么。

此属性仅在窗口类型为 com.foxit.sdk.pdf.Rendition.e_WindowTypeFloating 时有用。

返回
  浮动窗口屏幕外情况的事件类型。请参考从 com.foxit.sdk.pdf.Rendition.e_FloatingWindowOffscreenEventNone 开始的值，这将是这些值中的一个。 如果演示对象中未定义此属性的值， 默认返回 com.foxit.sdk.pdf.Rendition.e_FloatingWindowOffscreenEventMoveResize 。

## ◆ getFloatingWindowPosition()

int com.foxit.sdk.pdf.Rendition.getFloatingWindowPosition | ( |  | ) | throws com.foxit.sdk.PDFException

获取浮动窗口应相对于相关窗口定位的位置。

此属性仅在窗口类型为 com.foxit.sdk.pdf.Rendition.e_WindowTypeFloating 时有用。
窗口相对位置指定浮动窗口应定位到的位置。

返回
  位置值。请参考从 com.foxit.sdk.common.Constants.e_PosTopLeft 开始的值， 这将是这些值中的一个。如果演示对象中未定义此属性的值， 默认返回 com.foxit.sdk.common.Constants.e_PosCenter 。

## ◆ getFloatingWindowRelatedWindowType()

int com.foxit.sdk.pdf.Rendition.getFloatingWindowRelatedWindowType | ( |  | ) | throws com.foxit.sdk.PDFException

获取窗口相对类型。

此属性仅在窗口类型为 com.foxit.sdk.pdf.Rendition.e_WindowTypeFloating 时有用。
相关窗口类型指定浮动窗口应定位到的位置。

返回
  相关窗口类型。请参考从 com.foxit.sdk.pdf.Rendition.e_FloatingWindowRelatedWindowDocument 开始的值，这将是这些值中的一个。 如果演示对象中未定义此属性的值， 默认返回 com.foxit.sdk.pdf.Rendition.e_FloatingWindowRelatedWindowDocument 。

## ◆ getFloatingWindowResizeType()

int com.foxit.sdk.pdf.Rendition.getFloatingWindowResizeType | ( |  | ) | throws com.foxit.sdk.PDFException

获取调整大小类型，指定浮动窗口是否可以由用户调整大小。

此属性仅在窗口类型为 com.foxit.sdk.pdf.Rendition.e_WindowTypeFloating 时有用。

返回
  调整大小类型。请参考从 com.foxit.sdk.pdf.Rendition.e_FloatingWindowResizeTypeNo 开始的值， 这将是这些值中的一个。如果演示对象中未定义此属性的值， 默认返回 com.foxit.sdk.pdf.Rendition.e_FloatingWindowResizeTypeNo 。

## ◆ getFloatingWindowTitles()

WStringArray com.foxit.sdk.pdf.Rendition.getFloatingWindowTitles | ( |  | ) | throws com.foxit.sdk.PDFException

获取多语言文本数组，提供要在浮动窗口标题栏上显示的文本。

此属性仅在窗口类型为 com.foxit.sdk.pdf.Rendition.e_WindowTypeFloating 时有用。
多语言文本数组中的字符串是成对的：每对中的第一个字符串（ASCII字符串） 是语言标识符，第二个字符串是标题。

返回
  表示多语言文本数组的字符串数组。

## ◆ getFloatingWindowWidth()

int com.foxit.sdk.pdf.Rendition.getFloatingWindowWidth | ( |  | ) | throws com.foxit.sdk.PDFException

获取浮动窗口的宽度，以像素为单位。

当窗口类型为 com.foxit.sdk.pdf.Rendition.e_WindowTypeFloating 时，此属性是必需的。

返回
  浮动窗口的宽度，以像素为单位。

## ◆ getMediaBaseURL()

String com.foxit.sdk.pdf.Rendition.getMediaBaseURL | ( |  | ) | throws com.foxit.sdk.PDFException

获取基础URL。

基础URL是用于解析媒体数据中找到的任何相对URL的绝对URL。

返回
  基础URL。

## ◆ getMediaClipContentType()

String com.foxit.sdk.pdf.Rendition.getMediaClipContentType | ( |  | ) | throws com.foxit.sdk.PDFException

获取媒体数据的内容类型（MIME类型）。

内容类型指定由文件规范表示的媒体数据的类型。 内容类型字符串应符合Internet RFC 2045中描述的内容类型规范， 多用途Internet邮件扩展（MIME）第一部分：Internet消息主体的格式。

返回
  内容类型（MIME类型）。

## ◆ getMediaClipFile()

FileSpec com.foxit.sdk.pdf.Rendition.getMediaClipFile | ( |  | ) | throws com.foxit.sdk.PDFException

获取实际媒体数据的文件规范。

返回
  文件规范对象。

## ◆ getMediaClipName()

String com.foxit.sdk.pdf.Rendition.getMediaClipName | ( |  | ) | throws com.foxit.sdk.PDFException

获取媒体剪辑的名称，用于用户界面。

返回
  媒体剪辑的名称。

## ◆ getMediaDescriptions()

WStringArray com.foxit.sdk.pdf.Rendition.getMediaDescriptions | ( |  | ) | throws com.foxit.sdk.PDFException

获取多语言文本数组，在无法播放媒体剪辑数据时 提供替代文本描述。

多语言文本数组中的字符串成对出现：每对中的第一个字符串（ASCII字符串） 是语言标识符，第二个字符串是描述。

返回
  用于描述的多语言文本数组。

## ◆ getMediaPlayer()

MediaPlayer com.foxit.sdk.pdf.Rendition.getMediaPlayer | ( | int | type,
|  | int | index
| ) |  | throws com.foxit.sdk.PDFException

根据索引获取指定类型的媒体播放器对象。

参数

  [in] | type | 媒体播放器类型。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaPlayerMustUsed 开始的值， 这应该是这些值中的一个。
  [in] | index | 要检索的媒体播放器对象的索引。有效范围：从 0 到 (count-1)。 count 由函数 Rendition.getMediaPlayerCount 返回。

返回
  媒体播放器对象。

## ◆ getMediaPlayerCount()

int com.foxit.sdk.pdf.Rendition.getMediaPlayerCount | ( | int | type | ) | throws com.foxit.sdk.PDFException

获取指定类型的媒体播放器对象数量。

参数

  [in] | type | 媒体播放器类型。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaPlayerMustUsed 开始的值， 这应该是这些值中的一个。

返回
  指定类型的媒体播放器对象数量。

## ◆ getMonitorSpecifier()

int com.foxit.sdk.pdf.Rendition.getMonitorSpecifier | ( |  | ) | throws com.foxit.sdk.PDFException

获取监视器指定类型值。

监视器指定用于指定在多监视器系统中浮动或 全屏窗口应出现在哪个监视器上。

返回
  监视器指定类型值。请参考从 com.foxit.sdk.pdf.Rendition.e_MonitorSpecifierLargest 开始的值，这将是这些值中的一个。 如果演示对象中未定义此属性的值， 默认返回 com.foxit.sdk.pdf.Rendition.e_MonitorSpecifierLargest 。

## ◆ getPermission()

int com.foxit.sdk.pdf.Rendition.getPermission | ( |  | ) | throws com.foxit.sdk.PDFException

获取媒体权限。

媒体权限指示在什么情况下可以接受写入临时文件 来播放媒体剪辑。

返回
  媒体权限值。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaPermTempNever 开始的值， 这将是这些值中的一个。

## ◆ getRenditionName()

String com.foxit.sdk.pdf.Rendition.getRenditionName | ( |  | ) | throws com.foxit.sdk.PDFException

获取名称。

此名称可用于JavaScript动作的名称树查找，也可用于用户界面。

返回
  当前演示对象的名称。

## ◆ getRepeatCount()

int com.foxit.sdk.pdf.Rendition.getRepeatCount | ( |  | ) | throws com.foxit.sdk.PDFException

获取重复计数，类似于SMIL的repeatCount属性。

返回
  重复计数。0 表示永远重复。如果演示对象中未定义此属性的值， 默认返回 1。

## ◆ getVolume()

int com.foxit.sdk.pdf.Rendition.getVolume | ( |  | ) | throws com.foxit.sdk.PDFException

获取音量，以录制音量级别的百分比指定所需的音量级别。

返回
  音量值。0 表示静音。如果演示对象中未定义此属性的值， 默认返回 100。

## ◆ getWindowType()

int com.foxit.sdk.pdf.Rendition.getWindowType | ( |  | ) | throws com.foxit.sdk.PDFException

获取媒体应播放的窗口类型。

返回
  窗口类型值。请参考 com.foxit.sdk.pdf.Rendition.e_WindowTypeFloating 值，这将是这些值中的一个。如果演示对象中未定义此属性的值， 默认返回 com.foxit.sdk.pdf.Rendition.e_WindowTypeAnnotRect 。

## ◆ hasFloatingWindowCloseButton()

boolean com.foxit.sdk.pdf.Rendition.hasFloatingWindowCloseButton | ( |  | ) | throws com.foxit.sdk.PDFException

检查浮动窗口是否应包含允许用户 关闭浮动窗口的用户界面元素。

此属性仅在窗口类型为 com.foxit.sdk.pdf.Rendition.e_WindowTypeFloating 时有用。

返回
  true 表示浮动窗口应包含允许用户 关闭浮动窗口的用户界面元素，false 表示浮动窗口不需要 包含此类用户界面元素。如果演示对象中未定义此属性的值， 默认返回 true。

## ◆ hasFloatingWindowTitleBar()

boolean com.foxit.sdk.pdf.Rendition.hasFloatingWindowTitleBar | ( |  | ) | throws com.foxit.sdk.PDFException

检查浮动窗口是否应有标题栏。

此属性仅在窗口类型为 com.foxit.sdk.pdf.Rendition.e_WindowTypeFloating 时有用。

返回
  true 表示浮动窗口应有标题栏，false 表示 浮动窗口不需要有标题栏。如果演示对象中未定义此属性的值， 默认返回 true。

## ◆ hasMediaClip()

boolean com.foxit.sdk.pdf.Rendition.hasMediaClip | ( |  | ) | throws com.foxit.sdk.PDFException

检查当前演示对象是否包含媒体剪辑。

返回
  true 表示当前演示对象包含媒体剪辑，false 表示 当前演示对象不包含任何媒体剪辑。

## ◆ isAutoPlay()

boolean com.foxit.sdk.pdf.Rendition.isAutoPlay | ( |  | ) | throws com.foxit.sdk.PDFException

检查媒体激活时是否应自动播放。

返回
  true 表示媒体激活时应自动播放， false 表示媒体激活时应初始暂停 （例如，显示第一帧）。仅与可能暂停的媒体相关。 如果演示对象中未定义此属性的值，默认返回 true。

## ◆ isControlBarVisible()

boolean com.foxit.sdk.pdf.Rendition.isControlBarVisible | ( |  | ) | throws com.foxit.sdk.PDFException

检查播放时是否显示播放器特定的控制器用户界面 （例如，播放/暂停/停止控件）。

返回
  true 表示显示播放器特定的控制器用户界面， false 表示不显示此类用户界面。 如果演示对象中未定义此属性的值，默认返回 false。

## ◆ isEmpty()

boolean com.foxit.sdk.pdf.Rendition.isEmpty | ( |  | ) |

检查当前对象是否为空。

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

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

## ◆ removeMediaPlayer()

void com.foxit.sdk.pdf.Rendition.removeMediaPlayer | ( | int | type,
|  | MediaPlayer | player
| ) |  | throws com.foxit.sdk.PDFException

删除指定类型的媒体播放器对象。

参数

  [in] | type | 媒体播放器类型。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaPlayerMustUsed 开始的值， 这应该是这些值中的一个。
  [in] | player | 要删除的媒体播放器对象。

返回
  无。

## ◆ setBackgroundColor()

void com.foxit.sdk.pdf.Rendition.setBackgroundColor | ( | long | color,
|  | int | opt_type
| ) |  | throws com.foxit.sdk.PDFException

设置媒体正在播放的矩形的背景颜色。

参数

  [in] | color | 要设置的背景颜色。格式：0xRRGGBB。
  [in] | opt_type | 媒体选项类型。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaOptionMustBeHonored 开始的值，这应该是这些值中的一个。 默认值：com.foxit.sdk.pdf.Rendition.e_MediaOptionBestEffort 。

返回
  无。

## ◆ setBackgroundOpacity()

void com.foxit.sdk.pdf.Rendition.setBackgroundOpacity | ( | float | opacity,
|  | int | opt_type
| ) |  | throws com.foxit.sdk.PDFException

设置背景不透明度。（对于全屏和隐藏窗口将被忽略）

参数

  [in] | opacity | 背景不透明度。有效范围：0.0 到 1.0。 0.0 表示完全透明，1.0 表示完全不透明。
  [in] | opt_type | 媒体选项类型。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaOptionMustBeHonored 开始的值，这应该是这些值中的一个。 默认值：com.foxit.sdk.pdf.Rendition.e_MediaOptionBestEffort 。

返回
  无。

## ◆ setDuration()

void com.foxit.sdk.pdf.Rendition.setDuration | ( | int | duration,
|  | int | opt_type
| ) |  | throws com.foxit.sdk.PDFException

设置内在持续时间。

参数

  [in] | duration | 要设置的内在持续时间值。应该是： -2：使用内在持续时间； -1：无限持续时间； >= 0：显式持续时间。
  [in] | opt_type | 媒体选项类型。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaOptionMustBeHonored 开始的值，这应该是这些值中的一个。 默认值：com.foxit.sdk.pdf.Rendition.e_MediaOptionBestEffort 。

返回
  无。

## ◆ setFitStyle()

void com.foxit.sdk.pdf.Rendition.setFitStyle | ( | int | fit_style,
|  | int | opt_type
| ) |  | throws com.foxit.sdk.PDFException

设置适配样式。

适配样式（方式）指定播放器应如何处理与其播放矩形不完全匹配的 视觉媒体类型。

参数

  [in] | fit_style | 适配样式值。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaPlayerFitStyleMeet 开始的值，这应该是这些值中的一个。
  [in] | opt_type | 媒体选项类型。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaOptionMustBeHonored 开始的值，这应该是这些值中的一个。 默认值：com.foxit.sdk.pdf.Rendition.e_MediaOptionBestEffort 。

返回
  无。

## ◆ setFloatingWindowOffscreenEvent()

void com.foxit.sdk.pdf.Rendition.setFloatingWindowOffscreenEvent | ( | int | offscreen_event,
|  | int | opt_type
| ) |  | throws com.foxit.sdk.PDFException

设置事件类型，指定如果浮动窗口完全或部分位于屏幕外 （即在任何物理监视器上都不可见）时应发生什么。

此属性仅在窗口类型为 com.foxit.sdk.pdf.Rendition.e_WindowTypeFloating 时有用。

参数

  [in] | offscreen_event | 浮动窗口屏幕外情况的事件类型。请参考从 com.foxit.sdk.pdf.Rendition.e_FloatingWindowOffscreenEventNone 开始的值， 这应该是这些值中的一个。
  [in] | opt_type | 媒体选项类型。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaOptionMustBeHonored 开始的值，这应该是这些值中的一个。 默认值：com.foxit.sdk.pdf.Rendition.e_MediaOptionBestEffort 。

返回
  无。

## ◆ setFloatingWindowPosition()

void com.foxit.sdk.pdf.Rendition.setFloatingWindowPosition | ( | int | position,
|  | int | opt_type
| ) |  | throws com.foxit.sdk.PDFException

设置浮动窗口应相对于相关窗口定位的位置。

此属性仅在窗口类型为 com.foxit.sdk.pdf.Rendition.e_WindowTypeFloating 时有用。
窗口相对位置指定浮动窗口应定位到的位置。

参数

  [in] | position | 窗口相对类型。请参考从 com.foxit.sdk.pdf.Rendition.e_FloatingWindowRelatedWindowDocument 开始的值， 这应该是这些值中的一个。
  [in] | opt_type | 媒体选项类型。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaOptionMustBeHonored 开始的值，这应该是这些值中的一个。 默认值：com.foxit.sdk.pdf.Rendition.e_MediaOptionBestEffort 。

返回
  无。

## ◆ setFloatingWindowRelatedWindowType()

void com.foxit.sdk.pdf.Rendition.setFloatingWindowRelatedWindowType | ( | int | window_type,
|  | int | opt_type
| ) |  | throws com.foxit.sdk.PDFException

设置窗口相对类型。

此属性仅在窗口类型为 com.foxit.sdk.pdf.Rendition.e_WindowTypeFloating 时有用。
相关窗口类型指定浮动窗口应定位到的位置。

参数

  [in] | window_type | 相关窗口类型。请参考从 com.foxit.sdk.pdf.Rendition.e_FloatingWindowRelatedWindowDocument 开始的值， 这应该是这些值中的一个。
  [in] | opt_type | 媒体选项类型。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaOptionMustBeHonored 开始的值，这应该是这些值中的一个。 默认值：com.foxit.sdk.pdf.Rendition.e_MediaOptionBestEffort 。

返回
  无。

## ◆ setFloatingWindowResizeType()

void com.foxit.sdk.pdf.Rendition.setFloatingWindowResizeType | ( | int | resize_type,
|  | int | opt_type
| ) |  | throws com.foxit.sdk.PDFException

设置调整大小类型，指定浮动窗口是否可以由用户调整大小。

此属性仅在窗口类型为 com.foxit.sdk.pdf.Rendition.e_WindowTypeFloating 时有用。

参数

  [in] | resize_type | 调整大小类型。请参考从 com.foxit.sdk.pdf.Rendition.e_FloatingWindowResizeTypeNo 开始的值， 这应该是这些值中的一个。
  [in] | opt_type | 媒体选项类型。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaOptionMustBeHonored 开始的值，这应该是这些值中的一个。 默认值：com.foxit.sdk.pdf.Rendition.e_MediaOptionBestEffort 。

返回
  无。

## ◆ setFloatingWindowSize()

void com.foxit.sdk.pdf.Rendition.setFloatingWindowSize | ( | int | width,
|  | int | height,
|  | int | opt_type
| ) |  | throws com.foxit.sdk.PDFException

设置浮动窗口的大小，以像素为单位。

当窗口类型为 com.foxit.sdk.pdf.Rendition.e_WindowTypeFloating 时，此属性是必需的。

参数

  [in] | width | 浮动窗口的宽度，以像素为单位。此值应大于0。
  [in] | height | 浮动窗口的高度，以像素为单位。此值应大于0。
  [in] | opt_type | 媒体选项类型。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaOptionMustBeHonored 开始的值，这应该是这些值中的一个。 默认值：com.foxit.sdk.pdf.Rendition.e_MediaOptionBestEffort 。

返回
  无。

## ◆ setFloatingWindowTitles()

void com.foxit.sdk.pdf.Rendition.setFloatingWindowTitles | ( | WStringArray | titles,
|  | int | opt_type
| ) |  | throws com.foxit.sdk.PDFException

设置多语言文本数组，提供要在浮动窗口标题栏上显示的文本。

此属性仅在窗口类型为 com.foxit.sdk.pdf.Rendition.e_WindowTypeFloating 时有用。
多语言文本数组中的字符串是成对的：每对中的第一个字符串（ASCII字符串） 是语言标识符，第二个字符串是标题。

参数

  [in] | titles | 表示多语言文本数组的字符串数组。
  [in] | opt_type | 媒体选项类型。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaOptionMustBeHonored 开始的值，这应该是这些值中的一个。 默认值：com.foxit.sdk.pdf.Rendition.e_MediaOptionBestEffort 。

返回
  无。

## ◆ setMediaBaseURL()

void com.foxit.sdk.pdf.Rendition.setMediaBaseURL | ( | String | base_url,
|  | int | opt_type
| ) |  | throws com.foxit.sdk.PDFException

设置基础URL。

基础URL是用于解析媒体数据中找到的任何相对URL的绝对URL。

参数

  [in] | base_url | 要设置的基础URL。
  [in] | opt_type | 媒体选项类型。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaOptionMustBeHonored 开始的值，这应该是这些值中的一个。 默认值：com.foxit.sdk.pdf.Rendition.e_MediaOptionBestEffort 。

返回
  无。

## ◆ setMediaClipContentType()

void com.foxit.sdk.pdf.Rendition.setMediaClipContentType | ( | String | content_type | ) | throws com.foxit.sdk.PDFException

设置媒体数据的内容类型（MIME类型）。

内容类型指定由文件规范表示的媒体数据的类型。 内容类型字符串应符合Internet RFC 2045中描述的内容类型规范， 多用途Internet邮件扩展（MIME）第一部分：Internet消息主体的格式。
建议用户在通过函数 Rendition.setMediaClipFile 设置新文件规范时 设置内容类型。

参数

  [in] | content_type | 内容类型（MIME类型）。

返回
  无。

## ◆ setMediaClipFile()

void com.foxit.sdk.pdf.Rendition.setMediaClipFile | ( | FileSpec | file_specification | ) | throws com.foxit.sdk.PDFException

设置实际媒体数据的文件规范。

此属性对演示对象是必需的。建议用户在设置新文件规范后 通过函数 Rendition.setMediaClipContentType 设置内容类型。

参数

  [in] | file_specification | A file specification object.

返回
  None.

## ◆ setMediaClipName()

void com.foxit.sdk.pdf.Rendition.setMediaClipName | ( | String | name | ) | throws com.foxit.sdk.PDFException

设置媒体剪辑的名称，用于用户界面。

参数

  [in] | name | 要为媒体剪辑设置的名称字符串。

返回
  无。

## ◆ setMediaDescriptions()

void com.foxit.sdk.pdf.Rendition.setMediaDescriptions | ( | WStringArray | description_array | ) | throws com.foxit.sdk.PDFException

设置多语言文本数组，在无法播放媒体剪辑数据时 提供替代文本描述。

多语言文本数组中的字符串成对出现：每对中的第一个字符串（ASCII字符串） 是语言标识符，第二个字符串是描述。

参数

  [in] | description_array | 用于描述的多语言文本数组。

返回
  无。

## ◆ setMonitorSpecifier()

void com.foxit.sdk.pdf.Rendition.setMonitorSpecifier | ( | int | monitor_specifier,
|  | int | opt_type
| ) |  | throws com.foxit.sdk.PDFException

设置监视器指定类型值。

监视器指定用于指定在多监视器系统中浮动或 全屏窗口应出现在哪个监视器上。

参数

  [in] | monitor_specifier | 监视器指定类型值。请参考从 com.foxit.sdk.pdf.Rendition.e_MonitorSpecifierLargest 开始的值，这应该是这些值中的一个。
  [in] | opt_type | 媒体选项类型。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaOptionMustBeHonored 开始的值，这应该是这些值中的一个。 默认值：com.foxit.sdk.pdf.Rendition.e_MediaOptionBestEffort 。

返回
  无。

## ◆ setPermission()

void com.foxit.sdk.pdf.Rendition.setPermission | ( | int | permission | ) | throws com.foxit.sdk.PDFException

设置媒体权限。

媒体权限指示在什么情况下可以接受写入临时文件 来播放媒体剪辑。

参数

  [in] | permission | 媒体权限值。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaPermTempNever 开始的值，这应该是这些值中的一个。

返回
  无。

## ◆ setRenditionName()

void com.foxit.sdk.pdf.Rendition.setRenditionName | ( | String | name | ) | throws com.foxit.sdk.PDFException

设置名称。

此名称可用于JavaScript动作的名称树查找，也可用于用户界面。

参数

  [in] | name | 当前演示对象的名称。

返回
  无。

## ◆ setRepeatCount()

void com.foxit.sdk.pdf.Rendition.setRepeatCount | ( | int | count,
|  | int | opt_type
| ) |  | throws com.foxit.sdk.PDFException

设置重复计数，类似于SMIL的repeatCount属性。

参数

  [in] | count | 要设置的重复计数。0 表示永远重复。此值不应为负值。
  [in] | opt_type | 媒体选项类型。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaOptionMustBeHonored 开始的值，这应该是这些值中的一个。 默认值：com.foxit.sdk.pdf.Rendition.e_MediaOptionBestEffort 。

返回
  无。

## ◆ setVolume()

void com.foxit.sdk.pdf.Rendition.setVolume | ( | int | volume,
|  | int | opt_type
| ) |  | throws com.foxit.sdk.PDFException

设置音量，以录制音量级别的百分比指定所需的音量级别。

参数

  [in] | volume | 要设置的音量值。0 表示静音。此值不应为负数。
  [in] | opt_type | 媒体选项类型。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaOptionMustBeHonored 开始的值，这应该是这些值中的一个。 默认值：com.foxit.sdk.pdf.Rendition.e_MediaOptionBestEffort 。

返回
  无。

## ◆ setWindowType()

void com.foxit.sdk.pdf.Rendition.setWindowType | ( | int | window_type,
|  | int | opt_type
| ) |  | throws com.foxit.sdk.PDFException

设置媒体应播放的窗口类型。

参数

  [in] | window_type | 窗口类型值。请参考从 com.foxit.sdk.pdf.Rendition.e_WindowTypeFloating 开始的值，这应该是这些值中的一个。
  [in] | opt_type | 媒体选项类型。请参考从 com.foxit.sdk.pdf.Rendition.e_MediaOptionMustBeHonored 开始的值，这应该是这些值中的一个。 默认值：com.foxit.sdk.pdf.Rendition.e_MediaOptionBestEffort 。

返回
  无。