PdfAttachFile

obj -> PdfAttachFile(alpha1[, int2[, alpha3[, logic4]]]) : int

Anhangdatei zu PDF hinzufügen

Details

• obj: Deskriptor des PDF-Objekts
• alpha1: Pfad- und Dateiname der Anhangdatei
• int2: Verknüpfungsart der Anhangdatei
• alpha3: Beschreibung der Anhangdatei
• logic4: Anhang komprimieren
• Resultat: int Fehlerwert
• Siehe: Verwandte Befehle , PdfAttachMem () , PdfAttachExportFile () , Blog

Der Befehl fügt einem PDF eine extern vorliegende Anhangdatei hinzu. Das PDF muss zuvor mit der Anweisung PdfOpen () geöffnet worden sein.

Im Argument (alpha1) wird die einzufügende Anhangdatei angegeben.

Mit dem Argument (int2) kann die Verknüpfungsart definiert werden. Folgende Arten können angegeben werden:

• _PdfAttachAssociateNone Nur einfügen der Anhangdatei, keine weitere Verknüpfung.
• _PdfAttachAssociateAlternative Verknüpfung des Anhangs mit Beziehung "Alternative". Die Konstante sollte ab sofort anstelle von _PdfAttachAssociateZUGFeRD verwendet werden.
• _PdfAttachAssociateSource Verknüpfung des Anhangs mit Beziehung "Source".

Mit dem Argument (alpha3) kann eine Beschreibung für den Anhang angegeben werden.

Mit dem Argument (logic4) wird definiert, ob die Anhangdatei komprimiert werden soll.

info

Eine Komprimierung führt nicht immer zu einer Verkleinerung des PDF. Im Extremfall ist das resultierende PDF mit Komprimierung größer als ohne. Dies hängt von den im Anhang enthaltenen Daten ab. Textdateien lassen sich meist gut komprimieren, wohingegen bereits komprimierte Dateien (z. B. ZIP-Dateien) sich nicht weiter komprimieren lassen.

Der Rückgabewert kann mit folgenden Konstanten verglichen werden:

• _ErrOk: kein Fehler aufgetreten
• _ErrFsiNoFile: Pfad- oder Dateiname nicht gefunden
• _ErrOutOfMemory: Arbeitsspeicher nicht ausreichend

Mögliche Laufzeitfehler:

• _ErrHdlInvalid: Der in (obj) angegebene Deskriptor ist ungültig.
• _ErrValueInvalid: Kein Dateiname (alpha1) angegeben oder kein zulässiger Wert für die Verknüpfungsart (int2).