Programmierschnittstelle

Nachfolgend finden Sie eine Beschreibung aller vom PDF-Exportmodul unter­stützten Optionen. Diese Optionen können durch das Anwendungs­programm über die Funktion LlXSetParameter(..."PDF"...) gesetzt und über LlXGet­Para­meter(..."PDF"...) abgefragt werden.

PDF.Title: Spezifiziert den Titel des zu generierenden PDF-Dokuments.

PDF.Subject: Spezifiziert das Thema des zu generierenden PDF-Dokuments. Voreinstellung: leer.

PDF.Author: Setzt das Author-Tag in der PDF-Datei. Voreinstellung: leer.

PDF.Creator: Setzt das Creator-Tag in der PDF-Datei. Voreinstellung: leer.

PDF.Keywords: Spezifiziert die Stichwörter des zu generierenden PDF-Dokuments. Voreinstellung: leer.

PDF.Conformance: Wenn dieser Parameter gesetzt ist, kann die zu verwendende PDF-Version eingestellt werden. Bei aktivierter Verschlüsselung (siehe PDF.Encryption.EncryptFile) ergibt sich die Verschlüsselungsstärke automatisch. Es stehen diverse Optionen zur Verfügung, die im Folgenden erläutert werden.

PDF.Encryption.EncryptFile: Wenn dieser Parameter gesetzt ist, wird die Ergebnisdatei verschlüsselt. Die Verschlüsselungsart ergibt sich automatisch anhand der ausgewählte PDF-Version (siehe PDF.Conformance). Dann stehen diverse weitere Optionen zur Verfügung, die im Folgenden erläutert werden.

PDF.Encryption.EnablePrinting: Wenn dieser Parameter gesetzt ist, kann die Datei trotz Verschlüsselung gedruckt werden. Nur wirksam, wenn PDF.Encryption.EncryptFile auf "1" gesetzt wird.

PDF.Encryption.EnableChanging: Wenn dieser Parameter gesetzt ist, kann die Datei trotz Verschlüsselung bearbeitet werden. Nur wirksam, wenn PDF.Encryption.EncryptFile auf "1" gesetzt wird.

PDF.Encryption.EnableCopying: Wenn dieser Parameter gesetzt ist, können Teile der Datei trotz Verschlüsselung in die Zwischenablage übernommen werden. Nur wirksam, wenn PDF.Encryption.EncryptFile auf "1" gesetzt wird.

PDF.Encryption.EnableFillingForms: Wenn dieser Parameter gesetzt ist, können in der PDF-Datei trotz Verschlüsselung etwaige Formular- und auch Unterschriften-Felder ausgefüllt und verwendet werden. Nur wirksam, wenn PDF.Encryption.EncryptFile auf "1" gesetzt wird.

PDF.Encryption.EnableAnnotating: Wenn dieser Parameter gesetzt ist, kann in der PDF-Datei trotz Verschlüsselung kommentiert werden. Nur wirksam, wenn PDF.Encryption.EncryptFile auf "1" gesetzt wird.

PDF.FileAttachments: Mit diesem Parameter können zusätzliche Dateien in den PDF-Container hinzugefügt werden. Übergeben Sie diese wie folgt:

<Datei1>|<Beschreibung1>;<Datei2>|<Beschreibung2>

PDF.OwnerPassword: Das Besitzerpasswort für die verschlüsselte Datei. Dieses wird benötigt, um die Datei bearbeiten zu können. Wenn kein Passwort angegeben wird, wird die Datei mit einem zufälligen Passwort verschlüsselt. Wir empfehlen, immer ein geeignetes Passwort explizit zu wählen.

PDF.UserPassword: Das Benutzerpasswort für die verschlüsselte Datei. Dieses wird benötigt, um auf eine verschlüsselte Datei zugreifen zu können. Wenn kein Passwort angegeben wird, ist der Zugriff ohne Passwort möglich (evtl. mit Einschränkungen, s. o.).

PDF.UseSimpleFrames: Bestimmt, dass die einfachen Standardrahmenlinien für Tabellen und Objekte wie gepunktet, gestrichelt, gestrichelt-gepunktet und gestrichelt-gepunktet-gepunktet effektiver durch Windows gezeichnet werden sollen (abweichende Darstellung möglich). Das kann zu einer höheren Gesamtleistung und kleineren Exportdateien beim Erstellen von Berichten führen.

PDF.ExcludedFonts: Bestimmt, welche Schriftarten nicht eingebettet werden sollen. Einige Schriftarten (z. B. Arial, Courier) können identisch durch PostScript-Schriftarten ersetzt werden. Durch diese Option können einzelne Schriftarten explizit von der Einbettung ausgenommen werden. Bsp. "Arial;Courier;...". Voreinstellung: "Arial".

Hinweis: Wenn "*" angegeben wird, so werden keinerlei Schriftarten eingebettet, sondern lediglich der Name der enthaltenen Schriftarten. Dadurch wird das Windows Font Mapping des verwendeten PDF-Viewers aktiviert, der dann die möglichst passende Schriftart im System für die Darstellung verwendet. So kann die Dateigröße meist sehr klein gehalten werden.

PDF.ZUGFeRDXmlPath: Gibt den Pfad einer ZUGFeRD-konformen XML-Datei an, die in das Ergebnis-PDF eingebettet werden soll. Der ZUGFeRD-Conformance Level und die ZUGFeRD-Version werden dabei automatisch aus der übergebenen XML-Datei ausgelesen.

Picture.JPEGQuality: Spezifiziert die Qualität und den damit abhängigen Kompressionsfaktor der generierten JPEG Grafiken. Der Wert liegt zwischen 0 und 100, wobei 100 der höchsten JPEG Qualität (und damit vergleichsweise geringsten Kompression) entspricht. Wirkt sich nur aus, wenn die Quellgrafik nicht im JPEG-Format vorliegt, da eine Codierung von JPEG nach JPEG einen Qualitätsverlust mit sich bringen würde. Voreinstellung: 75

Export.File: Gibt den Dateinamen für das zu generierende PDF-Dokument an. Wenn leer, dann wird der Dateiauswahl-Dialog angezeigt.

Export.Path: Gibt den Pfad für das zu generierende PDF-Dokument an.

Export.Quiet: Gibt an, ob der Exportvorgang mit Benutzerinteraktion durchge­führt werden soll.

Export.ShowResult: Spezifiziert, ob im Anschluss an den Export, die mit der Dateiendung verknüpfte Anwendung automatisch gestartet werden soll.

Export.ShowResultAvailable: Hiermit kann die entsprechende Auswahlbox im Dateiauswahldialog versteckt werden.