Einstellungen der COM-Schnittstelle

Viele Profileinstellungen aus dem PDFCreator können ebenso durch die COM-Schnittstelle abgefragt und geändert werden.

Bemerkung

Wenn Sie Konten im COM-Interface verwenden wollen, müssen Sie diese zunächst in der PDFCreator Benutzeroberfläche anlegen und einem Profil zuordnen. Informationen zum Anlegen von Konten finden Sie hier im Abschnitt Konten.

Dazu stellt die PrintJob Klasse zwei Methoden zur Verfügung:

void SetProfileSetting(string name, string value)
string GetProfileSetting(string propertyName)

Man greift über den Namen auf die Eigenschaft zu und übergibt eine Zeichenkette, die den Wert beinhaltet, der der Eigenschaft zugewiesen werden soll. Eine Auflistung aller Einstellungen mit ihrer Bezeichnung, den Typ sowie einer Beschreibung finden Sie weiter unten. Der Wert ist eine Zeichenkette des zu setzenden Datentypes, d.h. „1.0“ für Werte vom Typ double oder „true“ für bool’sche Werte.

Gültige Beispiele(in C# syntax):

Job.SetProfileSetting("PdfSettings.Signing.Enabled", "true");
Job.SetProfileSetting("PdfSettings.Signing.DisplaySignatureOnPage", "CustomPage");
Job.SetProfileSetting("PdfSettings.Signing.DisplaySignatureOnCustomPage", "5");

Das folgende Beispiel aktiviert die digitale Signatur für PDF Dateien, dazu setzt man den Wert des Enums „DisplaySignatureOnPage“ auf „CustomPage“ , wobei der Wert für diese Seite auf 5 gesetzt wird. Alles, was C# in den Zieltyp konvertieren kann, kann hier gesetzt werden.

Bemerkung

Falls Sie Zahlen verwenden, dann achten Sie bitte darauf, dass sie international formatiert sind, d.h. keine Trennung von Tausendern und Trennung von Nachkommastellen durch einen Punkt, um zu gewährleisten, dass sie wie gewünscht konvertiert werden.

Einstellungen

Einstellung Typ Beschreibung
ActionOrder String Die Reihenfolge, in der die Aktionen beim Konvertieren ausgeführt werden
AuthorTemplate String Vorlage für das Verfasser-Feld. Hier dürfen Tokens enthalten sein.
FileNameTemplate String Vorlage des Dateinamens der Ausgabedateien. Hier dürfen Tokens enthalten sein.
Guid String GUID des Profils
KeywordTemplate String Vorlage für das Stichwörter-Feld. Hier dürfen Tokens enthalten sein.
Name String Name des Profils
OpenViewer Bool Öffnet das Standardprogramm nach dem Konvertieren des Dokuments
OpenWithPdfArchitect Bool Verwenden PDF Architect anstatt des Standardprogramms, wenn das Ausgabeformat PDF ist
OutputFormat Enum Standardformat für diesen Druckauftrag. Gültige Werte sind: Pdf, PdfA1B, PdfA2B, PdfA3B, PdfX, Jpeg, Png, Tif, Txt
SaveFileTemporary Bool Aktivieren, um dateien nur in einem temporären Verzeichnis zu speichern
ShowAllNotifications Bool Zeigt eine Benachrichtigung nach dem Konvertieren des Dokuments
ShowOnlyErrorNotifications Bool Nur Fehlerbenachrichtigungen anzeigen
ShowProgress Bool Wenn gesetzt, wird ein Fortschrittsfenster beim Konvertieren angezeigt
ShowQuickActions Bool Zeige Sofortaktionen nach der Konvertierung des Dokuments
SkipPrintDialog Bool Erlaubt den Druckdialog zu überspringen (wo die Metadaten eingestellt werden) und direkt zum Speichern-Dialog zu gelangen
SubjectTemplate String Vorlage für das Betreff-Feld. Hier dürfen Tokens enthalten sein.
TargetDirectory String Das Verzeichnis, in dem die Dateien gespeichert werden. (Im interaktiven Modus wird das Verzeichnis als Standardeinstellung genutzt)
TitleTemplate String Vorlage für das Titel-Feld. Hier dürfen Tokens enthalten sein.
AttachmentPage
Fügt dem konvertierten Dokument eine oder mehrere Seiten am Ende hinzu
AttachmentPage.Enabled Bool Aktiviert die AttachmentPage Aktion
AttachmentPage.File String Dateiname der PDF Datei, die angehängt werden soll
BackgroundPage
Dem resultierenden Dokument wird ein Hintergrund hinzugefügt
BackgroundPage.Enabled Bool Aktiviert die BackgroundPage Aktion
BackgroundPage.File String Der vollständige Dateiname der PDF Datei, die als Hintergrund benutzt werden soll
BackgroundPage.OnAttachment Bool Falls der Wert auf Wahr gesetzt ist, wird den Deckblattseiten ebenfalls ein Hintergrund hinzugefügt
BackgroundPage.OnCover Bool Falls der Wert auf Wahr gesetzt ist, wird den Anhangseiten ebenfalls ein Hintergrund hinzugefügt
BackgroundPage.Repetition Enum Legt die Art fest wie der Hintergrund des Dokumentes wiederholt wird. Gültige Werte sind: NoRepetition, RepeatAllPages, RepeatLastPage
CoverPage
Fügt eine oder mehrere Seiten am Anfang des konvertierten Dokumentes hinzu
CoverPage.Enabled Bool Aktiviert die CoverPage Aktion
CoverPage.File String Der vollständige Dateiname der PDF Datei, die vorne angefügt wird
CustomScript
Aktionen vor und nach der Konvertierung, die Aktionen aus angepassten Skripten ausführen können
CustomScript.Enabled Bool Aktiviert die Aktionen vor und nach der Konvertierung.
CustomScript.ScriptFilename String Dateiname des Custom-Scripts im Ordner ‚CS-Scripts‘ unterhalb des Anwendungsverzeichnisses
DropboxSettings
Dropbox-Einstellungen für den aktuellen Benutzer
DropboxSettings.AccountId String ID des verlinkten Kontos
DropboxSettings.CreateShareLink Bool  
DropboxSettings.Enabled Bool  
DropboxSettings.EnsureUniqueFilenames Bool Falls auf Wahr gesetzt, dann werden Dateien mit gleichen Namen auf dem Server nicht überschrieben, stattdessen wird eine Zahl an den Namen angehängt (d.h. document_2.pdf)
DropboxSettings.SharedFolder String  
EmailClientSettings
Öffnet das Standard-E-Mail Programm mit dem konvertierten Dokument als Anhang
EmailClientSettings.AddSignature Bool Der E-Mail die PDFCreator Signatur beifügen
EmailClientSettings.Content String Der Textinhalt der E-Mail
EmailClientSettings.Enabled Bool Aktiviert die EmailClient Aktion
EmailClientSettings.Html Bool Nutze HTML für den Inhalt der E-Mail
EmailClientSettings.Recipients String Die Liste der Empfänger dieser E-Mail, wie zum Beispiel info@someone.com; me@mywebsite.org
EmailClientSettings.RecipientsBcc String Die Liste der Empfänger dieser E-Mail im ‚BCC‘-Feld, wie zum Beispiel info@someone.com; me@mywebsite.org
EmailClientSettings.RecipientsCc String Die Liste der Empfänger dieser E-Mail im ‚CC‘-Feld, wie zum Beispiel info@someone.com; me@mywebsite.org
EmailClientSettings.Subject String Betreff der E-Mail
EmailSmtpSettings
Verschickt eine Nachricht ohne Nutzerinteraktion über SMTP
EmailSmtpSettings.AccountId String ID des verlinkten Kontos
EmailSmtpSettings.AddSignature Bool Der E-Mail die PDFCreator Signatur beifügen
EmailSmtpSettings.Content String Der Textinhalt der E-Mail
EmailSmtpSettings.Enabled Bool Falls Wahr, dann wird diese Aktion ausgeführt
EmailSmtpSettings.Html Bool Nutze HTML für den Inhalt der E-Mail
EmailSmtpSettings.Recipients String Die Liste der Empfänger dieser E-Mail, wie zum Beispiel info@someone.com; me@mywebsite.org
EmailSmtpSettings.RecipientsBcc String Die Liste der Empfänger dieser E-Mail im ‚BCC‘-Feld, wie zum Beispiel info@someone.com; me@mywebsite.org
EmailSmtpSettings.RecipientsCc String Die Liste der Empfänger dieser E-Mail im ‚CC‘-Feld, wie zum Beispiel info@someone.com; me@mywebsite.org
EmailSmtpSettings.Subject String Betreff der E-Mail
Ftp
Hochladen der konvertierten Dokumente mit FTP
Ftp.AccountId String ID des verlinkten Kontos
Ftp.Directory String Zielverzeichnis beim Server
Ftp.Enabled Bool Falls Wahr, dann wird diese Aktion ausgeführt
Ftp.EnsureUniqueFilenames Bool Falls auf Wahr gesetzt, dann werden Dateien mit gleichen Namen auf dem Server nicht überschrieben, stattdessen wird eine Zahl an den Namen angehängt (d.h. document_2.pdf)
Ghostscript
Ghostscript Einstellungen
Ghostscript.AdditionalGsParameters String Diese Parameter werden Ghostscript zusätzlich zu den PDFCreator Parametern zur Verfügung gestellt
HttpSettings
Aktion zum Hochladen von Dateien auf einen HTTP-Server
HttpSettings.AccountId String  
HttpSettings.Enabled Bool Falls Wahr, dann wird diese Aktion ausgeführt
JpegSettings
Einstellungen für das JPEG Ausgabeformat
JpegSettings.Color Enum Anzahl der Farben. Gültige Werte sind: Color24Bit, Gray8Bit
JpegSettings.Dpi Int Auflösung der JPEG Datei
JpegSettings.Quality Int Qualitätsfaktor der resultierenden JPEG Datei (100 ist das Beste, 0 das Schlechteste)
PdfSettings
Einstellungen für das PDF Ausgabeformat
PdfSettings.ColorModel Enum Farbmodel der PDF Datei (gilt nicht für Bilder). Gültige Werte sind: Rgb, Cmyk, Gray
PdfSettings.DocumentView Enum Legt fest welche Steuerelemente im Leseprogramm aktiviert werden sollen.Gültige Werte sind: NoOutLineNoThumbnailImages, Outline, ThumbnailImages, FullScreen, ContentGroupPanel, AttachmentsPanel
PdfSettings.EnablePdfAValidation Bool PDF/A-Validierung aktivieren
PdfSettings.NoFonts Bool Falls auf Wahr gesetzt, so wird keine Schriften in das Dokument eingebettet.
PdfSettings.PageOrientation Enum Legt fest wie die Seiten rotiert werden sollen. Gültige Werte sind: Automatic, Portrait, Landscape
PdfSettings.PageView Enum Legt fest wie das Dokument im Leseprogramm geöffnet wird. Gültige Werte sind: OnePage, OneColumn, TwoColumnsOddLeft, TwoColumnsOddRight, TwoPagesOddLeft, TwoPagesOddRight
PdfSettings.ViewerStartsOnPage Int Legt die Seitennummer fest, die beim Öffnen des Dokumentes als erstes angezeigt werden soll
CompressColorAndGray
Kompressionseinstellungen für Farb- und Graustufenbilder
PdfSettings.CompressColorAndGray.Compression Enum Einstellungen für die Kompressionsmethode. Gültige Werte sind: Automatic, JpegMaximum, JpegHigh, JpegMedium, JpegLow, JpegMinimum, JpegManual, Zip
PdfSettings.CompressColorAndGray.Dpi Int Bilder werden auf die höhste Auflösung umgerechnet, falls die Umrechnung aktiviert ist
PdfSettings.CompressColorAndGray.Enabled Bool Falls auf Wahr gesetzt, Farb- und Graustufen Bilder werden algorithmisch komprimiert. Falls auf Falsch gesetzt, bleiben sie unkomprimiert
PdfSettings.CompressColorAndGray.JpegCompressionFactor Double Legt einen vom Nutzer gewählten Kompressionsfaktor (benötigt hierfür die JpegManual Methode)
PdfSettings.CompressColorAndGray.Resampling Bool Falls Wahr, so werden die Bilder auf ihre maximale Auflösung umgerechnet
CompressMonochrome
Kompressionseinstellungen für monochrome Bilder
PdfSettings.CompressMonochrome.Compression Enum Einstellungen für die Kompressionsmethode. Gültige Werte sind: CcittFaxEncoding, Zip, RunLengthEncoding
PdfSettings.CompressMonochrome.Dpi Int Bilder werden auf die höhste Auflösung umgerechnet, falls die Umrechnung aktiviert ist
PdfSettings.CompressMonochrome.Enabled Bool Falls auf Wahr gesetzt, monochrome Bilder werden algorithmisch komprimiert, andernfalls bleiben sie unkomprimiert
PdfSettings.CompressMonochrome.Resampling Bool Falls Wahr, so werden die Bilder auf ihre maximale Auflösung umgerechnet
Security
PDF Sicherheitsoptionen
PdfSettings.Security.AllowPrinting Bool Nutzern es ermöglichen das Dokument auszudrucken
PdfSettings.Security.AllowScreenReader Bool Benutzern es ermöglichen Bildschirmleseprogramme zu verwenden
PdfSettings.Security.AllowToCopyContent Bool Nutzern ermöglichen den Inhalt der PDF Datei zu kopieren
PdfSettings.Security.AllowToEditAssembly Bool Nutzern ermöglichen die Anordnung zu verändern
PdfSettings.Security.AllowToEditComments Bool Nutzern ermöglichen Kommentare zu bearbeiten
PdfSettings.Security.AllowToEditTheDocument Bool Nutzern ermöglichen das Dokument zu bearbeiten
PdfSettings.Security.AllowToFillForms Bool Nutzern ermöglichen Felder auszufüllen
PdfSettings.Security.Enabled Bool Falls auf Wahr gesetzt, so wird die PDF Datei durch ein Passwort geschützt
PdfSettings.Security.EncryptionLevel Enum Legt den Verschlüsselungsgrad fest. Gültige Werte sind: Rc40Bit, Rc128Bit, Aes128Bit, Aes256Bit
PdfSettings.Security.OwnerPassword String Passwort, das zur Änderung des Dokumentes benutzt werden kann
PdfSettings.Security.RequireUserPassword Bool Falls auf Wahr gesetzt, wird ein Passwort benötigt, um das Dokument zu öffnen.
PdfSettings.Security.RestrictPrintingToLowQuality Bool Falls dieser Wert Wahr ist, so lässt es sich nur in niedriger Auflösung drucken
PdfSettings.Security.UserPassword String Passwort, dass zur Öffnung des Dokumentes genutzt werden muss (falls gesetzt)
Signature
Digitale Signierung des PDF Dokumentes
PdfSettings.Signature.AllowMultiSigning Bool Falls auf Wahr gesetzt, so kann die PDF Datei von anderen Personen signiert werden
PdfSettings.Signature.CertificateFile String Pfad zum Zertifikat
PdfSettings.Signature.DisplaySignatureInDocument Bool Falls auf Wahr gesetzt, so wird die Signatur in der PDF Datei angezeigt
PdfSettings.Signature.Enabled Bool Falls auf Wahr gesetzt, so wird die Signatur im PDF Dokument angezeigt
PdfSettings.Signature.LeftX Float Signatur Stelle: Obere linke Ecke (X teil)
PdfSettings.Signature.LeftY Float Signatur Stelle: Obere linke Ecke (Y teil)
PdfSettings.Signature.RightX Float Signatur Stelle: Untere rechte Ecke (X teil)
PdfSettings.Signature.RightY Float Signatur Stelle: Untere rechte Ecke (Y teil)
PdfSettings.Signature.SignContact String Kontaktname der Signatur
PdfSettings.Signature.SignLocation String Signatur Stelle
PdfSettings.Signature.SignReason String Grund der Signatur
PdfSettings.Signature.SignatureCustomPage Int Wenn die Signatur Seite auf benutzerdefiniert gesetzt ist, dann legt diese Eigenschaft fest, auf welche Seite die Signatur platziert wird
PdfSettings.Signature.SignaturePage Enum Legt die Seite fest, auf der die Signatur zu sehen ist. Gültige Werte sind: FirstPage, LastPage, CustomPage
PdfSettings.Signature.SignaturePassword String Passwort für die Zertifizierungsdatei
PdfSettings.Signature.TimeServerAccountId String ID des verknüpften Zeitserverkontos
PngSettings
Einstellungen für das PNG Ausgabeformat
PngSettings.Color Enum Anzahl der Farben. Gültige Werte sind: Color32BitTransp, Color24Bit, Color8Bit, Color4Bit, Gray8Bit, BlackWhite
PngSettings.Dpi Int Auflösung der PNG Datei
Printing
Drucke das Dokument durch einen physischen Drucker
Printing.Duplex Enum Legt die Duplex Druckeinstellung fest. Gültige Werte sind: Disable, LongEdge, ShortEdge
Printing.Enabled Bool Falls auf Wahr gesetzt, so wird das Dokument über einen physischen Drucker gedruckt
Printing.PrinterName String Name des Druckers, der genutzt werden soll, sofern SelectedPrinter gesetzt wurde.
Printing.SelectPrinter Enum Methode zum Auswählen des Druckers. Gültige Werte sind: DefaultPrinter, ShowDialog, SelectedPrinter
Scripting
Die Skript Aktion ermöglicht das Ausführen eines Skriptes nach dem Konvertierungsvorgang
Scripting.Enabled Bool Falls auf Wahr gesetzt, so wird das übergebene Skript oder die übergebene Anwendung ausgeführt
Scripting.ParameterString String Parameter, die zusätzlich zu den konvertierten Dokumenten dem Skript übergeben werden
Scripting.ScriptFile String Pfad zum Skript oder zur Anwendung
Scripting.Visible Bool Falls auf Falsch gesetzt, so wird das übergebene Skript oder die übergebene Anwendung ausgeführt, ohne ein Fenster anzuzeigen
Scripting.WaitForScript Bool Wartet, bis das Skript beendet wurde
Stamping
Platziert einen Stempel auf alle Seiten des Dokumentes
Stamping.Color Color Farbe des Textes
Stamping.Enabled Bool Falls auf Wahr gesetzt, so werden alle Seiten eines Dokumentes mit einem Stempel versehen
Stamping.FontAsOutline Bool Falls auf Wahr gesetzt, so wird der Text nur Umrissen dargestellt, andernfalls wird der Text gefüllt.
Stamping.FontName String Schriftartname.(Dies ist lediglich ein Hinweis, denn das PostScriptFontName enthält den richtigen Namen)
Stamping.FontOutlineWidth Int Stärke des Umrisses
Stamping.FontSize Float Schriftgröße
Stamping.FontFile String PostScript Name des Stempelschriftzuges .
Stamping.StampText String Text, der eingestempelt wird
TextSettings
TextSettings.Format Int Textformat (0 erstellt mit XML angereicherten Unicode zusammen mit Informationen zur Formatierung des Texts | 1 gleiche XML-Ausgabe, aber versucht eine ähnliche Verarbeitung wie MuPDF und erzeugt Textblöcke | 2 erzeugt Unicode-Text (UCS2) (mit Byte Order Mark), welcher versucht das Originallayout anzunähern | 3 wie 2, aber kodiert mit UTF-8)
TiffSettings
Einstellung für das TIFF Ausgabeformat
TiffSettings.Color Enum Anzahl Farben. Gültige Werte sind: Color24Bit, Color12Bit, Gray8Bit, BlackWhiteG3Fax, BlackWhiteG4Fax, BlackWhiteLzw
TiffSettings.Dpi Int Auflösung der TIFF Datei
UserTokens
PS-Dateien auf benutzerdefinierten Tokens parsen
UserTokens.Enabled Bool Parsen von PS-Dateien auf Benutzertokens aktivieren (Nur verfügbar in PDFCreator Business)
UserTokens.Seperator Enum Trennzeichen für UserTokens im Dokument. Gültige Werte: SquareBrackets, AngleBrackets