Die Aktion CS-Script ermöglicht es Ihnen, ein benutzerdefiniertes Skript in C# zu implementieren, um den Druckauftrag zu verarbeiten. Sie haben die Möglichkeit, direkt vor und unmittelbar nach der Konvertierung mit den gesamten Druckauftragsdaten (Sie greifen auf das eigentliche Auftragsobjekt zu) zu arbeiten. Alles mit der vollen in C# enthaltenen Funktionalität.
Bemerkung
Diese Funktion ist in unseren PDFCreator Business Editions enthalten
Die verwendete Technologie ist CS-Script. Ein CLR (Common Language Runtime) basiertes Skriptsystem, das ECMA-konformes C# als Programmiersprache verwendet. Damit stellen wir eine Schnittstelle mit Vor- und Nachkonvertierungsfunktionen für Ihre eigene Implementierung zur Verfügung.
Weitere Informationen zu CS-Script finden Sie in der offiziellen CS-Script-Dokumentation.
PDFCreator Server verwendet CodeDOM-Hosting. Bitte beachten Sie beim Lesen der Dokumentation die CodeDOM-Kompatibilität. Generell können Sie .net 4.5 mit C#5 verwenden.
Achtung
Sie können die CS-Script-Aktion im erweiterten Abschnitt der Warteschlangeneinstellungen aktivieren. Diese Einstellung aktiviert immer die Vor- und Nachkonvertierungsfunktionen. Wenn Sie eine der Funktionen deaktivieren möchten, implementieren Sie einfach eine leere Funktion mit einem erfolgreichen ScriptResultat (siehe PDFCreatorScript-Schnittstelle unten).
The script file must be a .cs or .csx file and must be located in the CS-Scripts-Ordner.
Alle verfügbaren Skriptdateien sind in der Dropdown-Liste aufgeführt. Falls die Datei nicht aufgelistet ist, klicken Sie bitte auf Aktualisieren. Mit CS-Scripts-Ordner öffnen können Sie den Speicherort der Skriptdatei im Windows-Explorer überprüfen.
Wenn ein Skript ausgewählt wird, wird es automatisch geprüft und kompiliert. Mögliche Fehler sind unter der Dropdown-Liste aufgeführt. Klicken Sie auf Skript prüfen, um die Prüfung zu wiederholen.
PDFCreator wird mit einer Beispielskriptdatei namens SetFilenameInPreConversionCreateBackUpInPostConversionScript.cs ausgeliefert. Sie befindet sich im Ordner CS-Scripts im Programmverzeichnis vom PDFCreator.
Das Skript legt vor der Konvertierung eine neue Ausgabedateivorlage fest und erstellt danach eine Sicherungsdatei. Der Sicherungsordner wird im Zielordner erstellt und nach dem Dateinamen mit angehängtem „_backup“ benannt. Das Skript ist erfolgreich, wenn die Sicherung erstellt wird, und bricht ab, wenn es fehlschlägt oder die Sicherungsdatei bereits existiert.
Das benutzerdefinierte Skript muss eine Klasse bereitstellen, die die PDFCreatorScript-Schnittstelle implementiert.
public interface IPDFCreatorScript
{
ScriptResult PreConversion(Job job, Logger logger);
ScriptResult PostConversion(Job job, Logger logger);
}
Die Funktion PreConversion wird unmittelbar vor der Konvertierung eines Dokuments aufgerufen, PostConversion direkt danach.
Verwenden Sie für Ihr Skript folgende using-Anweisungen:
using NLog;
using pdfforge.CustomScriptAction;
using pdfforge.PDFCreator.Conversion.Jobs.Jobs;
using pdfforge.PDFCreator.Conversion.Settings;
using pdfforge.PDFCreator.Utilities.Tokens;
Sie können die Dateien NLogg.dll, CustomScriptAction.dll, PDFCreator.Jobs.dll, PDFCreator.Settings.dll und die PDFCreator.Utilities.dll aus dem Programmverzeichnis vom PDFCreator verwenden, um sie in Ihre IDE einzubetten. Der Skript-Compiler berücksichtigt automatisch alle DLLs im PDFCreator Programmverzeichnis und im CS-Scripts-Ordner.
Bemerkung
Wenn Sie externe Bibliotheken referenzieren, müssen sich die erforderlichen DLL-Dateien im Programmverzeichnis vom PDFCreator oder im CS-Scripts-Ordner befinden.
Der Rückgabewert kann entweder ScriptResult.Success für eine erfolgreiche Ausführung (oder zumindest zur Fortsetzung des aktuellen Auftrags) oder ScriptResult.Abort zum Abbrechen des aktuellen Auftrags sein.
Sie können Aktionen innerhalb der ‚PreConversion‘-Methode aktivieren und konfigurieren. Dieser Codeblock zeigt, wie Sie die Aktionen ‚AttachmentPage‘ und ‚CoverPage‘ aktivieren, konfigurieren und ihre Reihenfolge ändern:
public ScriptResult PreConversion(Job job, Logger logger)
{
job.Profile.AttachmentPage.Enabled = true;
job.Profile.AttachmentPage.Files.Add(@"C:\attachment.pdf");
job.Profile.CoverPage.Enabled = true;
job.Profile.CoverPage.Files.Add(@"C:\cover.pdf");
job.Profile.ActionOrder.Remove("CoverPage"); // it's optional to modify the order
job.Profile.ActionOrder.Insert(0, "CoverPage");
}
Wenn sie aktiviert wird, wird die Aktion am Ende der Aktionsliste (innerhalb ihrer Kategorie, d.h. „Ändern“ oder „Senden“) hinzugefügt. Wenn Sie mehrere Aktionen hinzufügen, werden die Aktionen in der Reihenfolge ausgeführt, in der sie hinzugefügt wurden. Durch Ändern der Liste job.Profile.ActionOrder können Sie die Reihenfolge ändern (z.B. wenn andere Aktionen in der Benutzeroberfläche konfiguriert wurden, die nach der neuen Aktion ausgeführt werden sollen).
Der angegebene Logger ist der aktuelle Logger aus dem PDFCreator, so dass die Log-Einträge aus dem benutzerdefinierten Skript entsprechend dem aktuellen Log-Level in das allgemeine PDFCreator-Log aufgenommen werden (siehe Debug).
Der Logger ist ein NLog.Logger. Die üblichen Funktionen zum Protokollieren auf einer bestimmten Protokollebene sind:
logger.Debug(messagestring)
logger.Warn(messagestring)
logger.Warn(exception, messagestring)
logger.Error(messagestring)
logger.Error(exception, messagestring)
Die Job-Klasse enthält alle Daten der aktuellen Stelle einschließlich des aktuellen Profils (siehe unten).
Bemerkung
Die Job-Klasse arbeitet mit einer Kopie des aktuellen Profils und alle Jobdaten sind monetär. Geänderte Daten (einschließlich der Passwörter) werden nicht gespeichert und nach Beendigung des Jobs verworfen.
Zur Ausführungszeit des Skripts werden bereits einige Daten aus dem Profil verarbeitet. Alle aufgeführten Eigenschaften werden anstelle der zugehörigen Daten im Profil verwendet:
Dies ist die Vorlage für den vollständigen Pfad der zukünftigen Ausgabedatei. Verwendete Token sind bereits ersetzt. Falls zutreffend, wird der Ausgabedateiname automatisch um eine Seitenzahl (bei Multi-Dateiformaten) oder einen Zähler erweitert, um einen eindeutigen Dateinamen zu gewährleisten.
Liste der bei der Konvertierung erzeugten Ausgabedateien
Die Klasse JobPasswords enthält Eigenschaften für die Passwörter der einzelnen Aktionen.
Zum Beispiel:
job.Passwords.PdfUserPassword = "1234";
job.Passwords.PdfOwnerPassword = "Swordfish";
Bemerkung
Bei fehlenden Passwörtern wird die Profilprüfung fehlschlagen. Bitte deaktivieren Sie die betreffende Aktion in den Einstellungen und aktivieren Sie sie in der PreConversion-Funktion des Skripts.
Die Account-Klasse enthält Funktionen, um auf die Konten für jede Aktion zuzugreifen - übergeben Sie das aktuelle Profil, um das aktuelle Konto zu erhalten.
Zum Beispiel:
job.Accounts.GetFtpAccount(job.Profile);
Bemerkung
Bei unvollständigen Konten wird die Profilprüfung fehlschlagen. Bitte deaktivieren Sie die betreffende Aktion in den Einstellungen und aktivieren Sie sie in der PreConversion-Funktion des Skripts.
Das erforderliche Passwort muss in der Eigenschaft job.passwords festgelegt werden
Wenn Sie ein neues Konto erstellen möchten, müssen Sie ihm eine AccountId geben, das neue Konto zu job.accounts hinzufügen und die AccountId im Profil festlegen.
Enthält die Metadaten aus dem Druckauftrag, die Druckzeit (PrintDateTime) und eine Funktion zur Bestimmung der Gesamtseitenzahl: job.JobInfo.CalculateTotalPages()
Verwenden Sie den TokenReplacer, um die Werte aus Ihren UserTokens zu extrahieren.
var userTokenValue = job.TokenReplacer.GetToken("User").GetValueWithFormat("YourUserTokenKey");
//GetToken is always called with "User"
//Just change your requested UserToken key
Die Job-Klasse enthält das Profil mit den folgenden Einstellungen:
Einstellung |
Typ |
Beschreibung |
---|---|---|
ActionOrder |
Die Reihenfolge, in der die Aktionen beim Konvertieren ausgeführt werden |
|
AuthorTemplate |
Vorlage für das Verfasser-Feld. Hier dürfen Tokens enthalten sein. |
|
FileNameTemplate |
Vorlage des Dateinamens der Ausgabedateien. Hier dürfen Tokens enthalten sein. |
|
Guid |
GUID des Profils |
|
KeywordTemplate |
Vorlage für das Stichwörter-Feld. Hier dürfen Tokens enthalten sein. |
|
Name |
Name des Profils |
|
OutputFormat |
Standardformat für diesen Druckauftrag. Gültige Werte sind: Pdf, PdfA1B, PdfA2B, PdfA3B, PdfX, Jpeg, Png, Tif, Txt |
|
SaveFileTemporary |
Aktivieren, um Dateien nur in einem temporären Verzeichnis zu speichern |
|
ShowAllNotifications |
Zeigt eine Benachrichtigung nach dem Konvertieren des Dokuments |
|
ShowOnlyErrorNotifications |
Nur Fehlerbenachrichtigungen anzeigen |
|
ShowProgress |
Wenn gesetzt, wird ein Fortschrittsfenster beim Konvertieren angezeigt |
|
ShowQuickActions |
Zeige Sofortaktionen nach der Konvertierung des Dokuments |
|
SkipSendFailures |
Erlaub, mit weiteren Sendeaktionen fortzufahren, wenn ein Aktion fehlschlägt |
|
SubjectTemplate |
Vorlage für das Betreff-Feld. Hier dürfen Tokens enthalten sein. |
|
TargetDirectory |
Das Verzeichnis, in dem die Dateien gespeichert werden. (Im interaktiven Modus wird das Verzeichnis als Standardeinstellung genutzt) |
|
TitleTemplate |
Vorlage für das Titel-Feld. Hier dürfen Tokens enthalten sein. |
|
UseGsNewPDF |
Verwenden Sie den neuen Ghostscript PDF-Interpreter, der mit gs 9.55.0 eingeführt wurde |
|
WarnSendFailures |
Eine Warnung anzeigen, wenn Sendeaktionen fehlschlagen (nur, wenn SkipSendFailures aktiviert ist) |
|
AttachmentPage |
||
Fügt dem konvertierten Dokument eine oder mehrere Seiten am Ende hinzu |
||
AttachmentPage.Enabled |
Aktiviert die AttachmentPage Aktion |
|
AttachmentPage.Files |
Dateiname der PDF Datei, die angehängt werden soll |
|
BackgroundPage |
||
Dem resultierenden Dokument wird ein Hintergrund hinzugefügt |
||
BackgroundPage.Enabled |
Aktiviert die BackgroundPage Aktion |
|
BackgroundPage.File |
Der vollständige Dateiname der PDF Datei, die als Hintergrund benutzt werden soll |
|
BackgroundPage.FitToPage |
Aktivieren, um die Größe des Hintergrunds an die Dokumentseite anzupassen |
|
BackgroundPage.Opacity |
Deckkraft für Hintergrund in Prozent |
|
BackgroundPage.Repetition |
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 |
Aktiviert die CoverPage Aktion |
|
CoverPage.Files |
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 |
Aktiviert die Aktionen vor und nach der Konvertierung |
|
CustomScript.ScriptFilename |
Dateiname des Custom-Skripts im Ordner ‚CS-Scripts‘ unterhalb des Anwendungsverzeichnisses |
|
DropboxSettings |
||
Dropbox-Einstellungen für den aktuellen Benutzer |
||
DropboxSettings.AccountId |
ID des verlinkten Kontos |
|
DropboxSettings.CreateShareLink |
||
DropboxSettings.Enabled |
||
DropboxSettings.EnsureUniqueFilenames |
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 |
||
EmailClientSettings |
||
Öffnet das Standard-E-Mail Programm mit dem konvertierten Dokument als Anhang |
||
EmailClientSettings.AddSignature |
Der E-Mail die PDFCreator Signatur beifügen |
|
EmailClientSettings.AdditionalAttachments |
Die Liste der zusätzlichen Anhänge für die E-Mail |
|
EmailClientSettings.Content |
Der Textinhalt der E-Mail |
|
EmailClientSettings.Enabled |
Aktiviert die EmailClient Aktion |
|
EmailClientSettings.Format |
Einstellen des E-Mail-Body-Formats Gültige Werte sind: Html, Text |
|
EmailClientSettings.Recipients |
Die Liste der Empfänger der E-Mail, z.B. info@someone.com; me@mywebsite.org |
|
EmailClientSettings.RecipientsBcc |
Die Liste der Empfänger dieser E-Mail im ‚BCC‘-Feld, wie zum Beispiel info@someone.com; me@mywebsite.org |
|
EmailClientSettings.RecipientsCc |
Die Liste der Empfänger dieser E-Mail im ‚CC‘-Feld, wie zum Beispiel info@someone.com; me@mywebsite.org |
|
EmailClientSettings.Subject |
Betreff der E-Mail |
|
EmailSmtpSettings |
||
Verschickt eine Nachricht ohne Nutzerinteraktion über SMTP |
||
EmailSmtpSettings.AccountId |
ID des verlinkten Kontos |
|
EmailSmtpSettings.AddSignature |
Der E-Mail die PDFCreator Signatur beifügen |
|
EmailSmtpSettings.AdditionalAttachments |
Die Liste der zusätzlichen Anhänge für die E-Mail |
|
EmailSmtpSettings.Content |
Der Textinhalt der E-Mail |
|
EmailSmtpSettings.DisplayName |
Anzeigename für den E-Mail-Absender |
|
EmailSmtpSettings.Enabled |
Falls Wahr, dann wird diese Aktion ausgeführt |
|
EmailSmtpSettings.Format |
Einstellen des E-Mail-Body-Formats Gültige Werte sind: Html, Text |
|
EmailSmtpSettings.OnBehalfOf |
Falls gesetzt, wird es im Protokoll als From verwendet und die Adresse des Kontos wird als Sender gesetzt |
|
EmailSmtpSettings.Recipients |
Die Liste der Empfänger der E-Mail, z.B. info@someone.com; me@mywebsite.org |
|
EmailSmtpSettings.RecipientsBcc |
Die Liste der Empfänger dieser E-Mail im ‚BCC‘-Feld, wie zum Beispiel info@someone.com; me@mywebsite.org |
|
EmailSmtpSettings.RecipientsCc |
Die Liste der Empfänger dieser E-Mail im ‚CC‘-Feld, wie zum Beispiel info@someone.com; me@mywebsite.org |
|
EmailSmtpSettings.ReplyTo |
Gibt eine Adresse an, die zum Beantworten der E-Mail verwendet werden soll |
|
EmailSmtpSettings.Subject |
Betreff der E-Mail |
|
ForwardToFurtherProfile |
||
ForwardToFurtherProfile.Enabled |
||
ForwardToFurtherProfile.ProfileGuid |
||
Ftp |
||
Hochladen der konvertierten Dokumente mit FTP |
||
Ftp.AccountId |
ID des verlinkten Kontos |
|
Ftp.Directory |
Zielverzeichnis beim Server |
|
Ftp.Enabled |
Falls Wahr, dann wird diese Aktion ausgeführt |
|
Ftp.EnsureUniqueFilenames |
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 |
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 |
||
HttpSettings.Enabled |
Falls Wahr, dann wird diese Aktion ausgeführt |
|
JpegSettings |
||
Einstellungen für das JPEG Ausgabeformat |
||
JpegSettings.Color |
Anzahl der Farben. Gültige Werte sind: Color24Bit, Gray8Bit |
|
JpegSettings.Dpi |
Auflösung der JPEG Datei |
|
JpegSettings.Quality |
Qualitätsfaktor der resultierenden JPEG Datei (100 ist das Beste, 0 das Schlechteste) |
|
PageNumbers |
||
Einstellungen für Seitenzahlen. |
||
PageNumbers.AlternateCorner |
Ob die linke/rechte Ecke auf jeder Seite gewechselt werden soll. |
|
PageNumbers.BeginOn |
Die Seite, auf der die Nummerierung beginnen soll. |
|
PageNumbers.BeginWith |
Die Zahl, bei der die Zählung beginnt. |
|
PageNumbers.Enabled |
Falls Wahr, dann wird diese Aktion ausgeführt |
|
PageNumbers.FontColor |
Die Farbe der Seitenzahlen. |
|
PageNumbers.FontFile |
Die Schriftart für die Seitenzahlen. |
|
PageNumbers.FontName |
Der Name der Schriftart für die Seitenzahlen. |
|
PageNumbers.FontSize |
Die Größe der Seitenzahlen. |
|
PageNumbers.Format |
Format der Seitenzahlen. |
|
PageNumbers.HorizontalOffset |
Der horizontalbe Abstand vom Seitenrand zu den Seitenzahlen in Punkten. |
|
PageNumbers.Position |
Die Position der Seitenzahlen. Gültige Werte: BottomRight, BottomLeft, BottomCenter, TopRight, TopLeft, TopCenter, |
|
PageNumbers.UnitOfMeasurement |
Gibt die Maßeinhaeit für die Position der Seitenzahlen an. Gültige Werte: Centimeter, Inch |
|
PageNumbers.UnitOfMeasurement |
Die Seitenzahlen in römischen Ziffern darstellen. |
|
PageNumbers.VerticalOffset |
Der vertikale Abstand der Seitenzahlen vom Seitenrand in Punkten. |
|
PdfSettings |
||
Einstellungen für das PDF Ausgabeformat |
||
PdfSettings.ColorModel |
Farbmodel der PDF Datei (gilt nicht für Bilder). Gültige Werte sind: Rgb, Cmyk, Gray |
|
PdfSettings.DocumentView |
Legt fest welche Steuerelemente im Leseprogramm aktiviert werden sollen.Gültige Werte sind: NoOutLineNoThumbnailImages, Outline, ThumbnailImages, FullScreen, ContentGroupPanel, AttachmentsPanel |
|
PdfSettings.EnablePdfAValidation |
PDF/A-Validierung aktivieren |
|
PdfSettings.NoFonts |
Falls auf Wahr gesetzt, so wird keine Schriften in das Dokument eingebettet. |
|
PdfSettings.PageOrientation |
Legt fest wie die Seiten rotiert werden sollen. Gültige Werte sind: Automatic, Portrait, Landscape |
|
PdfSettings.PageView |
Legt fest wie das Dokument im Leseprogramm geöffnet wird. Gültige Werte sind: OnePage, OneColumn, TwoColumnsOddLeft, TwoColumnsOddRight, TwoPagesOddLeft, TwoPagesOddRight |
|
PdfSettings.ViewerStartsOnPage |
Legt die Seitennummer fest, die beim Öffnen des Dokumentes als erstes angezeigt werden soll |
|
CompressColorAndGray |
||
Kompressionseinstellungen für Farb- und Graustufenbilder |
||
PdfSettings.CompressColorAndGray.Compression |
Einstellungen für die Kompressionsmethode. Gültige Werte sind: Automatic, JpegMaximum, JpegHigh, JpegMedium, JpegLow, JpegMinimum, JpegManual, Zip |
|
PdfSettings.CompressColorAndGray.Dpi |
Bilder werden auf die höchste Auflösung umgerechnet, falls die Umrechnung aktiviert ist |
|
PdfSettings.CompressColorAndGray.Enabled |
Falls aktiviert, werden Farb- und Graustufenbilder algorithmisch komprimiert. Ansonsten bleiben sie unkomprimiert |
|
PdfSettings.CompressColorAndGray.JpegCompressionFactor |
Legt einen vom Nutzer gewählten Kompressionsfaktor fest (benötigt hierfür die JpegManual Methode) |
|
PdfSettings.CompressColorAndGray.Resampling |
Falls Wahr, so werden die Bilder auf ihre maximale Auflösung umgerechnet |
|
CompressMonochrome |
||
Kompressionseinstellungen für monochrome Bilder |
||
PdfSettings.CompressMonochrome.Compression |
Einstellungen für die Kompressionsmethode. Gültige Werte sind: CcittFaxEncoding, Zip, RunLengthEncoding |
|
PdfSettings.CompressMonochrome.Dpi |
Bilder werden auf die höchste Auflösung umgerechnet, falls die Umrechnung aktiviert ist |
|
PdfSettings.CompressMonochrome.Enabled |
Falls auf Wahr gesetzt, monochrome Bilder werden algorithmisch komprimiert, andernfalls bleiben sie unkomprimiert |
|
PdfSettings.CompressMonochrome.Resampling |
Falls Wahr, so werden die Bilder auf ihre maximale Auflösung umgerechnet |
|
Security |
||
PDF Sicherheitsoptionen |
||
PdfSettings.Security.AllowPrinting |
Nutzern ermöglichen das Dokument auszudrucken |
|
PdfSettings.Security.AllowScreenReader |
Benutzern es ermöglichen Bildschirmleseprogramme zu verwenden |
|
PdfSettings.Security.AllowToCopyContent |
Nutzern ermöglichen den Inhalt der PDF Datei zu kopieren |
|
PdfSettings.Security.AllowToEditAssembly |
Nutzern ermöglichen die Anordnung zu verändern |
|
PdfSettings.Security.AllowToEditComments |
Nutzern ermöglichen Kommentare zu bearbeiten |
|
PdfSettings.Security.AllowToEditTheDocument |
Nutzern ermöglichen das Dokument zu bearbeiten |
|
PdfSettings.Security.AllowToFillForms |
Nutzern ermöglichen Felder auszufüllen |
|
PdfSettings.Security.Enabled |
Falls auf Wahr gesetzt, so wird die PDF Datei durch ein Passwort geschützt |
|
PdfSettings.Security.EncryptionLevel |
Legt den Verschlüsselungsgrad fest. Gültige Werte sind: Rc40Bit, Rc128Bit, Aes128Bit, Aes256Bit |
|
PdfSettings.Security.OwnerPassword |
Passwort, das zur Änderung des Dokumentes benutzt werden kann |
|
PdfSettings.Security.RequireUserPassword |
Falls auf Wahr gesetzt, wird ein Passwort benötigt, um das Dokument zu öffnen. |
|
PdfSettings.Security.RestrictPrintingToLowQuality |
Falls dieser Wert Wahr ist, so lässt es sich nur in niedriger Auflösung drucken |
|
PdfSettings.Security.UserPassword |
Passwort, dass zur Öffnung des Dokumentes genutzt werden muss (falls gesetzt) |
|
Signature |
||
Digitale Signierung des PDF Dokumentes |
||
PdfSettings.Signature.AllowMultiSigning |
Falls auf Wahr gesetzt, so kann die PDF Datei von anderen Personen signiert werden |
|
PdfSettings.Signature.BackgroundImageFile |
Der Pfad zu der Hintergrunddatei. |
|
PdfSettings.Signature.CertificateFile |
Pfad zum Zertifikat |
|
PdfSettings.Signature.DisplaySignature |
Legt die Art fest, wie die Signatur angezeigt wird. Gültige Werte sind: NoDisplay, TextOnly, ImageOnly, ImageAndText |
|
PdfSettings.Signature.Enabled |
Falls auf Wahr gesetzt, so wird die Signatur im PDF Dokument angezeigt |
|
PdfSettings.Signature.FitTextToSignatureSize |
Größe des Unterschriftentextes so anpassen, dass er in die angezeigte Unterschrift passt |
|
PdfSettings.Signature.FontColor |
Schriftfarbe für den Text in der Signatur |
|
PdfSettings.Signature.FontFile |
PostScript Name der Stempelschriftart |
|
PdfSettings.Signature.FontName |
Schriftartname der Signaturschriftart. (Dies ist lediglich ein Hinweis, FontFile enthält den richtigen Namen) |
|
PdfSettings.Signature.FontSize |
Schriftgröße der Stempelschriftart |
|
PdfSettings.Signature.LeftX |
Signatur Stelle: Obere linke Ecke (X teil) |
|
PdfSettings.Signature.LeftY |
Signatur Stelle: Obere linke Ecke (Y teil) |
|
PdfSettings.Signature.RightX |
Signatur Stelle: Untere rechte Ecke (X teil) |
|
PdfSettings.Signature.RightY |
Signatur Stelle: Untere rechte Ecke (Y teil) |
|
PdfSettings.Signature.SignContact |
Kontaktname der Signatur |
|
PdfSettings.Signature.SignLocation |
Signatur Stelle |
|
PdfSettings.Signature.SignReason |
Grund der Signatur |
|
PdfSettings.Signature.SignatureCustomPage |
Wenn die Signatur Seite auf benutzerdefiniert gesetzt ist, dann legt diese Eigenschaft fest, auf welche Seite die Signatur platziert wird |
|
PdfSettings.Signature.SignaturePage |
Legt die Seite fest, auf der die Signatur zu sehen ist. Gültige Werte sind: FirstPage, LastPage, CustomPage |
|
PdfSettings.Signature.SignaturePassword |
Passwort für die Zertifizierungsdatei |
|
PdfSettings.Signature.TimeServerAccountId |
ID des verknüpften Zeitserverkontos |
|
PngSettings |
||
Einstellungen für das PNG Ausgabeformat |
||
PngSettings.Color |
Anzahl der Farben. Gültige Werte sind: Color32BitTransp, Color24Bit, Color8Bit, Color4Bit, Gray8Bit, BlackWhite |
|
PngSettings.Dpi |
Auflösung der PNG Datei |
|
Printing |
||
Drucke das Dokument durch einen physischen Drucker |
||
Printing.Duplex |
Legt die Duplex Druckeinstellung fest. Gültige Werte sind: Disable, LongEdge, ShortEdge |
|
Printing.Enabled |
Falls auf Wahr gesetzt, so wird das Dokument über einen physischen Drucker gedruckt |
|
Printing.FitToPage |
Wenn gesetzt, werden die Seiten des Dokuments an das Papierformat des Druckers angepasst. |
|
Printing.PrinterName |
Name des Druckers, der genutzt werden soll, sofern SelectedPrinter gesetzt wurde. |
|
Printing.SelectPrinter |
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 |
Falls auf Wahr gesetzt, so wird das übergebene Skript oder die übergebene Anwendung ausgeführt |
|
Scripting.ParameterString |
Parameter, die zusätzlich zu den konvertierten Dokumenten dem Skript übergeben werden |
|
Scripting.ScriptFile |
Pfad zum Skript oder zur Anwendung |
|
Scripting.Visible |
Falls auf Falsch gesetzt, so wird das übergebene Skript oder die übergebene Anwendung ausgeführt, ohne ein Fenster anzuzeigen |
|
Scripting.WaitForScript |
Warten, bis das Skript beendet wurde |
|
Stamping |
||
Platziert einen Stempel auf alle Seiten des Dokumentes |
||
Stamping.Color |
Farbe des Textes |
|
Stamping.Enabled |
Falls auf Wahr gesetzt, so werden alle Seiten eines Dokumentes mit einem Stempel versehen |
|
Stamping.FontAsOutline |
Falls aktiviert, wird der Text nur mit Umrissen dargestellt, andernfalls wird der Text gefüllt. |
|
Stamping.FontFile |
PostScript Name der Stempelschriftart. |
|
Stamping.FontName |
Schriftartname.(Dies ist lediglich ein Hinweis, denn das PostScriptFontName enthält den richtigen Namen) |
|
Stamping.FontOutlineWidth |
Stärke des Umrisses |
|
Stamping.FontSize |
Schriftgröße |
|
Stamping.StampText |
Text, der eingestempelt wird |
|
TextSettings |
||
TextSettings.Format |
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 |
Anzahl Farben. Gültige Werte sind: Color24Bit, Color12Bit, Gray8Bit, BlackWhiteG3Fax, BlackWhiteG4Fax, BlackWhiteLzw |
|
TiffSettings.Dpi |
Auflösung der TIFF Datei |
|
UserTokens |
||
PS-Dateien auf benutzerdefinierten Tokens parsen |
||
UserTokens.Enabled |
Parsen von PS-Dateien auf Benutzertokens aktivieren (Nur verfügbar in PDFCreator Business) |
|
UserTokens.Separator |
Trennzeichen für UserTokens im Dokument. Gültige Werte: SquareBrackets, AngleBrackets, |
|
Wasserzeichen |
||
Dem resultierenden Dokument wird ein Hintergrund hinzugefügt |
||
Watermark.Enabled |
Aktiviert die Wasserzeichen-Aktion |
|
Watermark.File |
Dateiname der PDF-Datei, die als Wasserzeichen verwendet wird |
|
Watermark.FitToPage |
Aktivieren, um die Größe des Wasserzeichens an die Dokumentseite anzupassen |
|
Watermark.Opacity |
Deckkraft für Wasserzeichen in Prozent |
|
Watermark.Repetition |
Legt die Art fest wie der Hintergrund des Dokumentes wiederholt wird. Gültige Werte sind: NoRepetition, RepeatAllPages, RepeatLastPage |