类 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 成员函数继承自 com.foxit.sdk.common.Base
synchronized void	delete ()
	直接清除C++相关资源。更多...

静态 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++相关资源。

返回: 无。

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

◆ 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 。

返回: 无。

Public 成员函数

静态 Public 属性

详细描述

构造及析构函数说明

◆ Rendition() [1/2]

◆ Rendition() [2/2]

成员函数说明

◆ addMediaPlayer()

◆ delete()

◆ enableAutoPlay()

◆ enableControlBarVisible()

◆ enableFloatingWindowCloseButton()

◆ enableFloatingWindowTitleBar()

◆ getBackgroundColor()

◆ getBackgroundOpacity()

◆ getDict()

◆ getDuration()

◆ getFitStyle()

◆ getFloatingWindowHeight()

◆ getFloatingWindowOffscreenEvent()

◆ getFloatingWindowPosition()

◆ getFloatingWindowRelatedWindowType()

◆ getFloatingWindowResizeType()

◆ getFloatingWindowTitles()

◆ getFloatingWindowWidth()

◆ getMediaBaseURL()

◆ getMediaClipContentType()

◆ getMediaClipFile()

◆ getMediaClipName()

◆ getMediaDescriptions()

◆ getMediaPlayer()

◆ getMediaPlayerCount()

◆ getMonitorSpecifier()

◆ getPermission()

◆ getRenditionName()

◆ getRepeatCount()

◆ getVolume()

◆ getWindowType()

◆ hasFloatingWindowCloseButton()

◆ hasFloatingWindowTitleBar()

◆ hasMediaClip()

◆ isAutoPlay()

◆ isControlBarVisible()

◆ isEmpty()

◆ removeMediaPlayer()

◆ setBackgroundColor()

◆ setBackgroundOpacity()

◆ setDuration()

◆ setFitStyle()

◆ setFloatingWindowOffscreenEvent()

◆ setFloatingWindowPosition()

◆ setFloatingWindowRelatedWindowType()

◆ setFloatingWindowResizeType()

◆ setFloatingWindowSize()

◆ setFloatingWindowTitles()

◆ setMediaBaseURL()

◆ setMediaClipContentType()

◆ setMediaClipFile()

◆ setMediaClipName()

◆ setMediaDescriptions()

◆ setMonitorSpecifier()

◆ setPermission()

◆ setRenditionName()

◆ setRepeatCount()

◆ setVolume()

◆ setWindowType()