在PDF 2.0中，定义了一个名为"关联文件"的新概念。关联文件提供了一种方法来将其他格式的内容与PDF文件的对象关联，并识别内容与对象之间的关系。此类关联文件使用文件规范字典（称为文件规范）指定。关联文件可以链接到PDF文档的目录、页面字典、图形对象、结构元素、XObject、DParts、注释字典等。特别地，与图形对象的关联文件意味着与标记内容项关联。
类 AssociatedFiles 是管理关联文件的类。它提供了计算/获取PDF字典或图形对象中关联文件的功能，将文件（由 FileSpec 表示）与目录、PDF页面、图形对象、表单XObject对象、注释对象等关联的功能。
特别地，当使用PDF文档构造关联文件对象时，相关PDF文档的文件版本将被设置为2.0。
更多...

类 com.foxit.sdk.pdf.AssociatedFiles 继承关系图:

Public 成员函数
	AssociatedFiles (AssociatedFiles other)
	构造函数，通过另一个关联文件对象。更多...

	AssociatedFiles (PDFDoc pdf_doc) throws com.foxit.sdk.PDFException
	构造函数，使用PDF文档。更多...

void	associateFile (Annot annot, FileSpec file_spec) throws com.foxit.sdk.PDFException
	将文件（由 FileSpec 表示）与PDF注释关联。更多...

void	associateFile (FormXObject form_xobject, FileSpec file_spec) throws com.foxit.sdk.PDFException
	将文件（由 FileSpec 表示）与表单XObject图形对象关联。更多...

void	associateFile (GraphicsObject graphics_object, int mark_content_item_index, PDFObject current_resource, String property_name, FileSpec file_spec) throws com.foxit.sdk.PDFException
	将文件（由 FileSpec 表示）与指定图形对象的标记内容项关联。更多...

void	associateFile (ImageObject image, FileSpec file_spec) throws com.foxit.sdk.PDFException
	将文件（由 FileSpec 表示）与图像图形对象关联。更多...

void	associateFile (PDFObject pdf_object, FileSpec file_spec) throws com.foxit.sdk.PDFException
	将文件（由 FileSpec 表示）与PDF字典对象关联，该字典对象代表注释、PDF页面或PDF文档中其他对象的字典。更多...

void	associateFile (PDFPage page, FileSpec file_spec) throws com.foxit.sdk.PDFException
	将文件（由 FileSpec 表示）与PDF页面关联。更多...

synchronized void	delete ()
	直接清除C++相关资源。更多...

FileSpec	getAssociatedFile (GraphicsObject graphics_object, int index) throws com.foxit.sdk.PDFException
	通过索引获取图形对象中的关联文件。更多...

FileSpec	getAssociatedFile (PDFObject pdf_object, int index) throws com.foxit.sdk.PDFException
	通过索引获取指定PDF字典对象中的关联文件（由 FileSpec 表示）。更多...

int	getAssociatedFilesCount (GraphicsObject graphics_object) throws com.foxit.sdk.PDFException
	获取图形对象中关联文件的数量。更多...

int	getAssociatedFilesCount (PDFObject pdf_object) throws com.foxit.sdk.PDFException
	获取PDF字典对象中关联文件的数量，该字典对象代表注释、PDF页面或PDF文档中其他对象的字典。更多...

boolean	isEmpty ()
	检查当前对象是否为空。更多...

void	removeAssociatedFile (GraphicsObject graphics_object, int index) throws com.foxit.sdk.PDFException
	通过索引移除图形对象中的关联文件。更多...

void	removeAssociatedFile (PDFObject pdf_object, int index) throws com.foxit.sdk.PDFException
	通过索引移除指定PDF字典对象中的关联文件（由 FileSpec 表示）。更多...

静态 Public 属性
static final int	e_RelationshipAlternative = 3
	关系是"替代"，表示文件规范是内容的替代表示，例如音频。

static final int	e_RelationshipData = 2
	关系是"数据"，表示文件规范代表用于派生视觉呈现的信息 - 例如表格或图形。

static final int	e_RelationshipEncryptedPayload = 5
	关系是"加密负载"，表示文件规范是加密负载文档，如果PDF处理器有解密文档所需的加密过滤器，则应向用户显示。

static final int	e_RelationshipFormData = 6
	关系是"表单数据"，表示文件规范是与PDF文件中"AcroForm"字典关联的数据。

static final int	e_RelationshipSchema = 7
	关系是"模式"，表示文件规范是关联对象的模式定义。

static final int	e_RelationshipSource = 1
	关系是"源"，表示文件规范是关联内容的原始源材料。

static final int	e_RelationshipSupplement = 4
	关系是"补充"，表示文件规范代表原始源或数据的补充表示，可能更容易使用。

static final int	e_RelationshipUnspecified = 0
	关系未知或无法用其他值描述。

详细描述

在PDF 2.0中，定义了一个名为"关联文件"的新概念。关联文件提供了一种方法来将其他格式的内容与PDF文件的对象关联，并识别内容与对象之间的关系。此类关联文件使用文件规范字典（称为文件规范）指定。关联文件可以链接到PDF文档的目录、页面字典、图形对象、结构元素、XObject、DParts、注释字典等。特别地，与图形对象的关联文件意味着与标记内容项关联。
类 AssociatedFiles 是管理关联文件的类。它提供了计算/获取PDF字典或图形对象中关联文件的功能，将文件（由 FileSpec 表示）与目录、PDF页面、图形对象、表单XObject对象、注释对象等关联的功能。
特别地，当使用PDF文档构造关联文件对象时，相关PDF文档的文件版本将被设置为2.0。

构造及析构函数说明

◆ AssociatedFiles() [1/2]

com.foxit.sdk.pdf.AssociatedFiles.AssociatedFiles ( AssociatedFiles other )

构造函数，通过另一个关联文件对象。

参数

[in] other 另一个关联文件对象。

◆ AssociatedFiles() [2/2]

com.foxit.sdk.pdf.AssociatedFiles.AssociatedFiles ( PDFDoc pdf_doc ) throws com.foxit.sdk.PDFException

构造函数，使用PDF文档。

当通过此构造函数构造关联文件对象时，输入PDF文档的文件版本将被设置为2.0。

参数

[in] pdf_doc 有效的PDF文档对象。

成员函数说明

◆ associateFile() [1/6]

void com.foxit.sdk.pdf.AssociatedFiles.associateFile	(	Annot	annot,
		FileSpec	file_spec
	)		throws com.foxit.sdk.PDFException

将文件（由 FileSpec 表示）与PDF注释关联。

实际上，此函数等于将文件与PDF注释的PDF字典关联。

参数

[in]	annot	有效的PDF注释。
[in]	file_spec	要与指定PDF注释对象关联的文件规范对象。它不应该是空字符串。

返回: 无。

◆ associateFile() [2/6]

void com.foxit.sdk.pdf.AssociatedFiles.associateFile	(	FormXObject	form_xobject,
		FileSpec	file_spec
	)		throws com.foxit.sdk.PDFException

将文件（由 FileSpec 表示）与表单XObject图形对象关联。

实际上，此函数等于将文件与表单XObject图形对象的PDF字典关联。

参数

[in]	form_xobject	表单XObject图形对象。它不应该是 null。
[in]	file_spec	要与指定表单XObject图形对象关联的文件规范对象。它不应该是空字符串。

返回: 无。

◆ associateFile() [3/6]

void com.foxit.sdk.pdf.AssociatedFiles.associateFile	(	GraphicsObject	graphics_object,
		int	mark_content_item_index,
		PDFObject	current_resource,
		String	property_name,
		FileSpec	file_spec
	)		throws com.foxit.sdk.PDFException

将文件（由 FileSpec 表示）与指定图形对象的标记内容项关联。

参数

[in]	graphics_object	有效的图形对象。
[in]	mark_content_item_index	输入图形对象中标记内容项的索引，指定的文件规范对象将与之关联。有效范围：从0到（count-1）。count 由函数 graphics.MarkedContent.getItemCount 返回，该函数用于与输入图形对象相关的标记内容。
[in]	current_resource	与输入图形对象相关的PDF页面的资源字典。这也可以是引用此类PDF字典的PDF引用对象。
[in]	property_name	在输入资源字典的"Properties"字典中使用的属性名称。它不应该是空字符串。
[in]	file_spec	要与指定图形对象的指定标记内容项关联的文件规范对象。它不应该是空字符串。

返回: 无。

注解: 当此函数成功时，应调用函数 GraphicsObjects.generateContent 。请参考函数 GraphicsObjects.generateContent 了解更多详情。

◆ associateFile() [4/6]

void com.foxit.sdk.pdf.AssociatedFiles.associateFile	(	ImageObject	image,
		FileSpec	file_spec
	)		throws com.foxit.sdk.PDFException

将文件（由 FileSpec 表示）与图像图形对象关联。

实际上，此函数等于将文件与图像图形对象的PDF字典关联。

参数

[in]	image	图像图形对象。它不应该是 null。
[in]	file_spec	要与指定图像图形对象关联的文件规范对象。它不应该是空字符串。

返回: 无。

◆ associateFile() [5/6]

void com.foxit.sdk.pdf.AssociatedFiles.associateFile	(	PDFObject	pdf_object,
		FileSpec	file_spec
	)		throws com.foxit.sdk.PDFException

将文件（由 FileSpec 表示）与PDF字典对象关联，该字典对象代表注释、PDF页面或PDF文档中其他对象的字典。

参数

[in]	pdf_object	有效的PDF对象。它应该是PDF字典对象或引用PDF字典对象的PDF引用对象。
[in]	file_spec	要与指定PDF字典关联的文件规范对象。它不应该是空字符串。

返回: 无。

◆ associateFile() [6/6]

void com.foxit.sdk.pdf.AssociatedFiles.associateFile	(	PDFPage	page,
		FileSpec	file_spec
	)		throws com.foxit.sdk.PDFException

将文件（由 FileSpec 表示）与PDF页面关联。

实际上，此函数等于将文件与PDF页面字典关联。

参数

[in]	page	有效的PDF页面。
[in]	file_spec	要与指定PDF页面关联的文件规范对象。它不应该是空字符串。

返回: 无。

◆ delete()

synchronized void com.foxit.sdk.pdf.AssociatedFiles.delete ( )

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

返回: 无。

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

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

◆ getAssociatedFile() [1/2]

FileSpec com.foxit.sdk.pdf.AssociatedFiles.getAssociatedFile	(	GraphicsObject	graphics_object,
		int	index
	)		throws com.foxit.sdk.PDFException

通过索引获取图形对象中的关联文件。

一个或多个文件可能通过将内容流中的这些部分包围在标记内容之间来与内容流中的内容部分关联。因此，实际上，此函数是获取与图形对象相关的标记内容中的关联文件（由索引指定）。

参数

[in]	graphics_object	有效的PDF图形对象。
[in]	index	指定PDF图形对象中关联文件的索引。有效范围：从0到（count-1）。count 由函数 AssociatedFiles.getAssociatedFilesCount 返回，使用相同的参数 graphics_object。

返回: 代表预期关联文件的文件规范对象。

◆ getAssociatedFile() [2/2]

FileSpec com.foxit.sdk.pdf.AssociatedFiles.getAssociatedFile	(	PDFObject	pdf_object,
		int	index
	)		throws com.foxit.sdk.PDFException

通过索引获取指定PDF字典对象中的关联文件（由 FileSpec 表示）。

参数

[in]	pdf_object	有效的PDF对象。它应该是PDF字典对象或引用PDF字典对象的PDF引用对象。
[in]	index	指定PDF字典对象中关联文件的索引。有效范围：从0到（count-1）。count 由函数 AssociatedFiles.getAssociatedFilesCount 返回，使用相同的参数 object。

返回: 代表预期关联文件的文件规范对象。

◆ getAssociatedFilesCount() [1/2]

int com.foxit.sdk.pdf.AssociatedFiles.getAssociatedFilesCount ( GraphicsObject graphics_object ) throws com.foxit.sdk.PDFException

获取图形对象中关联文件的数量。

一个或多个文件可能通过将内容流中的这些部分包围在标记内容之间来与内容流中的内容部分关联。因此，实际上，此函数是计算与图形对象相关的标记内容中的关联文件。

参数

[in] graphics_object 有效的PDF图形对象。

返回: 关联文件的数量。

◆ getAssociatedFilesCount() [2/2]

int com.foxit.sdk.pdf.AssociatedFiles.getAssociatedFilesCount ( PDFObject pdf_object ) throws com.foxit.sdk.PDFException

获取PDF字典对象中关联文件的数量，该字典对象代表注释、PDF页面或PDF文档中其他对象的字典。

参数

[in] pdf_object 有效的PDF对象。它应该是PDF字典对象或引用PDF字典对象的PDF引用对象。

返回: 关联文件的数量。

◆ isEmpty()

boolean com.foxit.sdk.pdf.AssociatedFiles.isEmpty ( )

检查当前对象是否为空。

当前对象为空时，表示当前对象是无用的。

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

◆ removeAssociatedFile() [1/2]

void com.foxit.sdk.pdf.AssociatedFiles.removeAssociatedFile	(	GraphicsObject	graphics_object,
		int	index
	)		throws com.foxit.sdk.PDFException

通过索引移除图形对象中的关联文件。

一个或多个文件可以通过在标记内容之间包围内容流的某些部分来与这些部分关联。因此，实际上，此函数用于移除与图形对象相关的标记内容中的关联文件。

参数

[in]	graphics_object	有效的PDF图形对象。
[in]	index	指定PDF图形对象中关联文件的索引。有效范围：从0到（count-1）。count 由函数 AssociatedFiles.getAssociatedFilesCount 使用相同的参数 graphics_object 返回。

返回: 无。

◆ removeAssociatedFile() [2/2]

void com.foxit.sdk.pdf.AssociatedFiles.removeAssociatedFile	(	PDFObject	pdf_object,
		int	index
	)		throws com.foxit.sdk.PDFException

通过索引移除指定PDF字典对象中的关联文件（由 FileSpec 表示）。

参数

[in]	pdf_object	有效的PDF对象。它应该是PDF字典对象或引用PDF字典对象的PDF引用对象。
[in]	index	指定PDF字典对象中关联文件的索引。有效范围：从0到（count-1）。count 由函数 AssociatedFiles.getAssociatedFilesCount 使用相同的参数 object 返回。

返回: 无。

Public 成员函数

静态 Public 属性

详细描述

构造及析构函数说明

◆ AssociatedFiles() [1/2]

◆ AssociatedFiles() [2/2]

成员函数说明

◆ associateFile() [1/6]

◆ associateFile() [2/6]

◆ associateFile() [3/6]

◆ associateFile() [4/6]

◆ associateFile() [5/6]

◆ associateFile() [6/6]

◆ delete()

◆ getAssociatedFile() [1/2]

◆ getAssociatedFile() [2/2]

◆ getAssociatedFilesCount() [1/2]

◆ getAssociatedFilesCount() [2/2]

◆ isEmpty()

◆ removeAssociatedFile() [1/2]

◆ removeAssociatedFile() [2/2]