PdfAttachMem

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

handle1 ist der Deskriptor des Memory-Objektes mit den Anhangdaten.

Im Argument (alpha2) wird ein interner Name für die einzufügende Anhangdatei angegeben.

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

• _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 (alpha4) kann eine Beschreibung für den Anhang angegeben werden.

Mit dem Argument (logic5) 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
• _ErrOutOfMemory: Arbeitsspeicher nicht ausreichend

Mögliche Laufzeitfehler:

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