AddFileAttachmentA
文档属性
描述
末尾的 A 表示 ANSI（char）DLL 入口点；ActiveX/COM 接口仅公开 Unicode 形式。其行为与 AddFileAttachment 相同，字符串参数使用当前 SetAnsiMode 代码页进行解释
将现有嵌入文件注册为 PDF 查看器中的文档级附件，显示“附件”面板的阅读器会显示所提供的标题，并在用户选择它时打开所引用的嵌入文件
请先调用 AddEmbeddedFile，将文件字节复制到文档中并获取 EmbeddedFileID。随后 AddFileAttachment 会将该文件规范添加至 Catalog /Names /EmbeddedFiles 名称树，而不会重复嵌入字节
PDF 版本行为：AddEmbeddedFile 会生成嵌入文件流和文件规范字典，这要求 PDF 1.3。在文档级 /Names /EmbeddedFiles 名称树中注册文件要求 PDF 1.4。如果当前文档版本较低且未锁定保存版本，AddFileAttachment 会自动将文档提升到 PDF 1.4，并在 /EmbeddedFiles name tree 的 AutoBumpedFeatures 中记录该操作。如果调用方锁定较低的保存版本，兼容性门会以 LastErrorCode 602 拒绝保存
语法
Delphi
Function DLAddFileAttachmentA(InstanceID: Integer; Title: PAnsiChar; EmbeddedFileID: Integer): Integer;DLL
int DLAddFileAttachmentA(int InstanceID, const char * Title, int EmbeddedFileID);参数
| Title | 在查看器中显示并作为 /EmbeddedFiles 名称树键的附件名称，不得为空 |
|---|---|
| EmbeddedFileID | 由 AddEmbeddedFile 返回的值 |
返回值
| 0 | EmbeddedFileID 无效、标题为空，或没有活动文档 |
|---|---|
| 1 | 嵌入文件已注册为文档级附件 |
备注
此函数创建文档级附件列表条目。若要在页面上放置可单击图标或热点，请改用 AddLinkToEmbeddedFile。若要在一次调用中嵌入并注册文件，请使用 EmbedFile
另请参阅
AddEmbeddedFile、AddLinkToEmbeddedFile、EmbedFile、SetEmbeddedFileAFRelationship、EmbeddedFileCount