AddFileAttachment

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

Описание

Регистрира съществуващ вграден файл като прикачен файл на ниво документ в PDF прегледача. Читателите, които показват панела Attachments, изобразяват подаденото заглавие и отварят препратения вграден файл, когато потребителят го избере

Извикайте първо AddEmbeddedFile, за да копирате байтовете на файла в документа и да получите EmbeddedFileID. AddFileAttachment след това добавя тази file specification към дървото от имена /Names /EmbeddedFiles в Catalog, без да дублира вградените байтове

Поведение според версията на PDF: AddEmbeddedFile извежда потоци на вградени файлове и речници file specification, които изискват 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	Името на прикачения файл, показвано във viewer-а и използвано като ключ в дървото от имена `/EmbeddedFiles`. Не трябва да е празно
EmbeddedFileID	Стойността, върната от AddEmbeddedFile

Върнати стойности

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

Бележки

Тази функция създава запис в списъка с прикачени файлове на ниво документ. За да поставите щракваща икона или активна зона на страница, използвайте AddLinkToEmbeddedFile вместо това. За да вградите и регистрирате файл с едно извикване, използвайте EmbedFile

Вижте също

AddEmbeddedFile, AddLinkToEmbeddedFile, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount