AddFileAttachment

Dokumenteigenschaften

Beschreibung

Prüfen Sie Syntax, Parameter und Rückgabewerte, bevor Sie die Funktion aufrufen Die Codeblöcke bleiben im Original erhalten, damit Beispiele unverändert übernommen werden können.

Rufen Sie zunächst AddEmbeddedFile auf, um die Dateibytes in das Dokument zu kopieren und die EmbeddedFileID zu erhalten. AddFileAttachment fügt diese Dateispezifikation anschließend dem Namensbaum /Names /EmbeddedFiles des Katalogs hinzu, ohne die eingebetteten Bytes zu duplizieren.

Verhalten der PDF-Version: AddEmbeddedFile gibt den eingebetteten Dateistream und die Dateispezifikationswörterbücher aus, wofür PDF 1.3 erforderlich ist. Für die Registrierung der Datei im dokumentweiten Namensbaum /Names /EmbeddedFiles ist PDF 1.4 erforderlich. Ist die aktuelle Dokumentversion niedriger und die Speicherversion nicht gesperrt, hebt AddFileAttachment das Dokument automatisch auf PDF 1.4 an und trägt /EmbeddedFiles name tree in AutoBumpedFeatures ein. Sperrt der Aufrufer eine niedrigere Speicherversion, lehnt die Kompatibilitätsprüfung das Speichern mit LastErrorCode 602 ab.

Syntax

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);

Parameter

TitleDer im Viewer angezeigte Name des Anhangs, der zugleich als Schlüssel im Namensbaum /EmbeddedFiles verwendet wird. Er darf nicht leer sein.
EmbeddedFileIDDer von AddEmbeddedFile zurückgegebene Wert.

Rückgabewerte

0Die EmbeddedFileID ist ungültig, der Titel ist leer oder es ist kein Dokument aktiv.
1Die eingebettete Datei wurde als Anhang auf Dokumentebene registriert.

Hinweise

Prüfen Sie Syntax, Parameter und Rückgabewerte, bevor Sie die Funktion aufrufen Die Codeblöcke bleiben im Original erhalten, damit Beispiele unverändert übernommen werden können. AddLinkToEmbeddedFile, EmbedFile

Siehe auch

AddEmbeddedFile, AddLinkToEmbeddedFile, EmbedFile, SetEmbeddedFileAFRelationship, EmbeddedFileCount