AddFileAttachmentA

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

Описание

The trailing A denotes the ANSI (char) DLL entry point; the ActiveX/COM surface exposes only the Unicode form. Behaviour is identical to AddFileAttachment and string arguments are interpreted using the current SetAnsiMode code page

Регистрирует существующий встроенный файл как вложение уровня документа в 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 DLAddFileAttachmentA(InstanceID: Integer; Title: PAnsiChar; EmbeddedFileID: Integer): Integer;

DLL

int DLAddFileAttachmentA(int InstanceID, const char * Title, int EmbeddedFileID);

Параметры

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

Примечания

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

См. также

AddEmbeddedFile, AddLinkToEmbeddedFile, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount