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

Public 成员函数

 Attachments (foxit.pdf.PDFDoc doc, PDFNameTree nametree)
 构造函数,带参数。从PDF文档对象和EmbeddedFiles名称树(如果有的话)构造。 更多...
 
 Attachments (Attachments other)
 构造函数,通过另一个附件对象。 更多...
 
bool AddEmbeddedFile (string key, FileSpec file_spec)
 使用新键名添加嵌入附件(作为文件规范对象)。 更多...
 
bool AddFromFilePath (string key, string file_path)
 使用新键名从指定文件路径添加新附件。 更多...
 
bool ExtractEmbeddedFileTo (string key, string dst_file_path)
 提取附件并将其保存到指定文件路径。 更多...
 
int GetCount ()
 获取附件的数量。 更多...
 
FileSpec GetEmbeddedFile (string key)
 获取指定键的附件(作为文件规范对象)。 更多...
 
string GetKey (int index)
 通过索引获取EmbeddedFiles名称树中定义的附件键。 更多...
 
PDFNameTree GetNameTree ()
 获取EmbeddedFiles名称树。 更多...
 
bool IsEmpty ()
 检查当前对象是否为空。 更多...
 
bool RemoveAllEmbeddedFiles ()
 移除所有附件。 更多...
 
bool RemoveEmbeddedFile (string key)
 通过键移除附件。 更多...
 
bool SetEmbeddedFile (string key, FileSpec file_spec)
 为指定键设置嵌入附件(作为文件规范对象)。 更多...
 

详细描述

在应用程序中,文档的嵌入文件被称为PDF附件。此类提供了一种比类 foxit.pdf.objects.PDFNameTree 更便捷的方式, 用于获取/设置PDF文档的EmbeddedFiles名称树中的嵌入文件(也称为附件文件)。

参见
PDFDoc
foxit.pdf.objects.PDFNameTree

构造及析构函数说明

◆ Attachments() [1/2]

foxit.pdf.Attachments.Attachments ( foxit.pdf.PDFDoc  doc,
PDFNameTree  nametree 
)
inline

构造函数,带参数。从PDF文档对象和EmbeddedFiles名称树(如果有的话)构造。

  • 如果未指定名称树对象,此函数将从PDF文档构造附件对象: 如果PDF文档中存在EmbeddedFiles名称树,此函数只是构造一个与名称树关联的附件对象; 如果PDF文档中没有这样的名称树,构造的附件对象可以用于在PDF文档中创建这样的名称树 并向名称树添加一些嵌入文件。

  • 如果指定了EmbeddedFiles名称树,此函数将从名称树以及相关的PDF文档构造附件对象。

参数
[in]doc有效的PDF文档对象。
[in]nametree表示EmbeddedFiles名称树的PDF名称树对象。 如果此PDF名称树对象是通过默认构造函数构造的且未设置任何值, 这意味着附件对象将从PDF文档构造;否则,请确保它属于 参数 doc 指定的PDF文档。 默认值:通过默认构造函数构造且未设置任何值的PDF名称树对象。

◆ Attachments() [2/2]

foxit.pdf.Attachments.Attachments ( Attachments  other)
inline

构造函数,通过另一个附件对象。

参数
[in]other另一个附件对象。

成员函数说明

◆ AddEmbeddedFile()

bool foxit.pdf.Attachments.AddEmbeddedFile ( string  key,
FileSpec  file_spec 
)
inline

使用新键名添加嵌入附件(作为文件规范对象)。

EmbeddedFiles名称树中的所有附件都按其键排序。 当添加新附件时,Foxit PDF SDK将在名称树中找到合适的位置来添加它。 添加成功后,一些旧键的索引可能会发生变化。

参数
[in]key新键字符串。如果这是一个空字符串,将使用输入的 file_spec 的名称 作为新键。此新键不应该已存在于当前附件对象所属的PDF文档中。
[in]file_spec要用新键添加的文件规范对象。它应该是有效的, 并且应该已嵌入到与当前附件对象相同的PDF文档中。
返回
true 表示成功,false 表示失败。

◆ AddFromFilePath()

bool foxit.pdf.Attachments.AddFromFilePath ( string  key,
string  file_path 
)
inline

使用新键名从指定文件路径添加新附件。

EmbeddedFiles名称树中的所有附件都按其键排序。 当添加新附件时,Foxit PDF SDK将在名称树中找到合适的位置来添加它。 添加成功后,一些旧键的索引可能会发生变化。

参数
[in]key新键字符串。如果这是一个空字符串,将使用输入的 file_spec 的名称 作为新键。此新键不应该已存在于当前附件对象所属的PDF文档中。
[in]file_path指定要嵌入到PDF文档并添加到EmbeddedFiles名称树的文件的文件路径。
返回
true 表示成功,false 表示失败。

◆ ExtractEmbeddedFileTo()

bool foxit.pdf.Attachments.ExtractEmbeddedFileTo ( string  key,
string  dst_file_path 
)
inline

提取附件并将其保存到指定文件路径。

参数
[in]key键字符串。这不应该是空字符串。
[in]dst_file_path文件路径,附件数据将保存到此路径。 这不应该是空字符串。
返回
true 表示成功,false 表示失败。

◆ GetCount()

int foxit.pdf.Attachments.GetCount ( )
inline

获取附件的数量。

返回
附件的数量。

◆ GetEmbeddedFile()

FileSpec foxit.pdf.Attachments.GetEmbeddedFile ( string  key)
inline

获取指定键的附件(作为文件规范对象)。

参数
[in]key键字符串。它不应该是空字符串。
返回
文件规范对象。

◆ GetKey()

string foxit.pdf.Attachments.GetKey ( int  index)
inline

通过索引获取EmbeddedFiles名称树中定义的附件键。

参数
[in]index要检索的键字符串的索引。有效范围:从0到(count-1)。 count 由函数 Attachments.GetCount 返回。
返回
键字符串。

◆ GetNameTree()

PDFNameTree foxit.pdf.Attachments.GetNameTree ( )
inline

获取EmbeddedFiles名称树。

返回
EmbeddedFiles名称树。

◆ IsEmpty()

bool foxit.pdf.Attachments.IsEmpty ( )
inline

检查当前对象是否为空。

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

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

◆ RemoveAllEmbeddedFiles()

bool foxit.pdf.Attachments.RemoveAllEmbeddedFiles ( )
inline

移除所有附件。

返回
true 表示成功,false 表示失败。

◆ RemoveEmbeddedFile()

bool foxit.pdf.Attachments.RemoveEmbeddedFile ( string  key)
inline

通过键移除附件。

如果输入键在EmbeddedFiles名称树中不存在, 此函数将直接返回 true

参数
[in]key键字符串。这不应该是空字符串。
返回
true 表示成功,false 表示失败。

◆ SetEmbeddedFile()

bool foxit.pdf.Attachments.SetEmbeddedFile ( string  key,
FileSpec  file_spec 
)
inline

为指定键设置嵌入附件(作为文件规范对象)。

参数
[in]key键字符串。它不应该是空字符串。 此名称应该已存在于当前PDF文档中。
[in]file_spec要设置为键值的文件规范对象。它应该是有效的, 并且应该已嵌入到与当前附件对象相同的PDF文档中。
返回
true 表示成功,false 表示失败。