AddFileAttachment

Свойства документа

Описание

Регистрирует существующий встроенный файл как вложение уровня документа в PDF-просмотрщике. Читатели с панелью Attachments показывают указанный заголовок и открывают встроенный файл по выбору пользователя

Сначала вызовите 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 TPDFlib.AddFileAttachment(Const Title: WideString; EmbeddedFileID: Integer): Integer;

ActiveX

Function PDFlib::AddFileAttachment(Title As String, EmbeddedFileID As Long) As Long

DLL

int DLAddFileAttachment(int InstanceID, const wchar_t * Title, int EmbeddedFileID);

Параметры

Title	Имя вложения, показываемое в просмотрщике и служащее ключом в дереве имён `/EmbeddedFiles`; пустым быть не может
EmbeddedFileID	Значение, возвращаемое AddEmbeddedFile

Возвращаемые значения

0	Недопустимый EmbeddedFileID, пустой заголовок либо активного документа нет
1	Встроенный файл зарегистрирован как вложение уровня документа

Примечания

Функция создаёт запись в списке вложений уровня документа. Для кликабельного значка или активной области на странице используйте AddLinkToEmbeddedFile, а чтобы встроить файл и зарегистрировать его одним вызовом — EmbedFile

См. также

AddEmbeddedFile, AddLinkToEmbeddedFile, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount