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
| Title | Der im Viewer angezeigte Name des Anhangs, der zugleich als Schlüssel im Namensbaum /EmbeddedFiles verwendet wird. Er darf nicht leer sein. |
|---|---|
| EmbeddedFileID | Der von AddEmbeddedFile zurückgegebene Wert. |
Rückgabewerte
| 0 | Die EmbeddedFileID ist ungültig, der Titel ist leer oder es ist kein Dokument aktiv. |
|---|---|
| 1 | Die 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