Foxit PDF SDK
com.foxit.sdk.pdf.Rendition类 参考
类 com.foxit.sdk.pdf.Rendition 继承关系图:
com.foxit.sdk.common.Base

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_playtrue 表示媒体激活时应自动播放, 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_visibletrue 表示显示播放器特定的控制器用户界面, 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_visibletrue 表示浮动窗口应包含允许用户 关闭浮动窗口的用户界面元素,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_visibletrue 表示浮动窗口应有标题栏,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_specificationA 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
返回
无。