SET PRINT OPTION

Home

4D v16.3

SET PRINT OPTION


SET PRINT OPTION ( Option ; Wert1 {; Wert2} )

Parameter	Typ	Beschreibung
Option	Lange Ganzzahl	Optionsnummer oder PDF Optionscode
Wert1	Lange Ganzzahl, Text	Wert 1 der Option
Wert2	Lange Ganzzahl, Text	Wert 2 der Option

Beschreibung

Der Befehl SET PRINT OPTION verändert per Programmierung den Wert der Druckoption. Jede über diesen Befehl definierte Option gilt für die gesamte Datenbank und die Dauer der Sitzung, solange kein anderer Befehl aufgerufen wird, der die Druckparameter verändert, z.B. PRINT SETTINGS, PRINT SELECTION ohne den Parameter >. Wurde ein Druckauftrag geöffnet, wird die Option gesetzt und kann erst nach Beenden des Druckauftrags verändert werden.

Der Parameter Option gibt die zu verändernde Option an. Sie können eine vordefinierte Konstante unter dem Thema Druckoptionen übergeben oder den Code einer PDF Option (nur mit dem Treiber PDFCreator unter Windows).

In Wert1 und optional Wert2 übergeben Sie den bzw. die neuen Werte der definierten Option. Die Anzahl und Art der zu übergebenden Werte richtet sich nach der Art der angegebenen Option.

Optionsnummer (Konstante) verwenden

Nachfolgende Liste zeigt die Optionen und ihre möglichen Werte:

Konstante	Typ	Wert	Kommentar
Paper option	Lange Ganzzahl	1	Verwenden Sie nur Wert1, enthält er den Namen des Papierformats. Verwenden Sie beide Parameter, enthält Wert1 die Papierbreite und Wert2 die Papierhöhe. Breite und Höhe werden in Pixel auf dem Bildschirm angegeben. Über den Befehl PRINT OPTION VALUES erhalten Sie Name, Höhe und Breite aller Papierformate, die der Drucker anbietet.
Orientation option	Lange Ganzzahl	2	Nur Wert1: 1=Hochformat, 2=Querformat. Bei einer anderen Ausrichtung gibt GET PRINT OPTION 0 in Wert1 zurück. 64-bit Versionen: Diese Option lässt sich im Druckauftrag aufrufen, d.h. Sie können im gleichen Auftrag zwischen Hoch- und Querformat wechseln.
Scale option	Lange Ganzzahl	3	nur Wert1: Skalierungswert in Prozent. Bedenken Sie jedoch, dass einige Drucker keine Skalierung zulassen. Übergeben Sie einen ungültigen Wert, wird die Eigenschaft beim Drucken auf 100% gesetzt.
Number of copies option	Lange Ganzzahl	4	nur Wert1: Anzahl der Kopien zum Drucken
Paper source option	Lange Ganzzahl	5	(nur Windows) nur Wert1: Nummer, die dem Index des zu verwendenden Papierschachts entspricht. Über den Befehl PRINT OPTION VALUES erhalten Sie das Array mit den Namen. Diese Option ist nur unter Windows verwendbar.
Color option	Lange Ganzzahl	8	(nur Windows) nur Wert1: Code zum Verwalten der Farbe: 1=schwarz/weiß (monochrome), 2=Farbe. 64-bit Versionen: Diese Option wird in 4D 64-bit Versionen nicht unterstützt (überholt)
Destination option	Lange Ganzzahl	9	Wert1: Code für Druckausgabe: 1=Drucker, 2=(PC)/PS File (Mac), 3=PDF Datei, 5=Bildschirm (OS X Treiber). Ist Wert1 ungleich 1 oder 5, enthält Wert2 den Pfadnamen des Ergebnisdokuments. Dieser Pfad wird benützt, bis ein anderer Pfad angegeben wird. Gibt es bereits eine gleichnamige Datei am Zielort, wird sie ersetzt. Ist der aktuelle Wert nicht in der vordefinierten Liste, enthält Wert1 mit GET PRINT OPTION -1 und die Systemvariable OK wird auf 1 gesetzt. Tritt ein Fehler auf, werden Wert1 und die Systemvariable OK auf 0 gesetzt. Hinweis: Unter Windows können Sie das Druckziel auf 3 (PDF-Datei) setzen, wenn der Treiber PDF Creator installiert ist. Werden die Werte (9;3;Pfad) übergeben, startet 4D automatisch ein "stilles" PDF Drucken, das alle übergebenen Codes für Option berücksichtigt. Übergeben Sie in Wert2 einen leeren String oder lassen diesen Parameter weg, erscheint beim Drucken ein Sichern-Dialog. Nach dem Drucken wird wieder auf die aktuellen Einstellungen zurückgesetzt. Das vereinfacht das Steuern von Drucken als PDF für 4D und ermöglicht das Schreiben von Multiplattform Code. Sind die Werte (9;3;Pfad) nicht übergeben, wird das Drucken nicht durch 4D gesteuert und alle für PDF Creator übergebenen Optionen werden ignoriert.
Double sided option	Lange Ganzzahl	11	(nur Windows) Wert1: 0=Einseitig oder Standard), 1=Doppelseitig. Ist Wert1=1, enthält Wert2 die Bindung: 0=Bindung links (Standard), 1=Bindung oben. Hinweis: Diese Option ist nur unter Windows verwendbar.
Spooler document name option	Lange Ganzzahl	12	nur Wert1: Namen des aktuellen Druckdokuments, das in der Dokumentenliste des Druck-Servers erscheint. Der hier definierte Name wird für alle Druckdokumente der Sitzung verwendet, solange kein neuer Name oder ein leerer String übergeben wird. Um die Standardoperation wiederherzustellen (Methodenname statt Methode, Tabellenname für Datensatz, etc.), übergeben Sie in Wert1 einen leeren String.
Mac spool file format option	Lange Ganzzahl	13	(nur Mac) nur Wert1: 0= Druckauftrag im PDF-Modus (Standardwert) 1=Druckauftrag im PostScript Modus Hinweise: - Diese Option hat keine Auswirkung unter Windows. - Auf Mac OS X wird standardmäßig im PDF-Modus gedruckt. Der PDF-Treiber unterstützt jedoch keine PICT-Bilder mit eingebundener PostScript Information – diese Bilder werden über vektororientierte Programme erstellt. Um dieses Problem zu vermeiden, können Sie über diese Option den Druckmodus für die aktuelle Sitzung auf Mac OS X verändern. Bedenken Sie, dass das Drucken im PostScript Modus unerwünschte Nebenwirkungen haben kann. 64-bit Versionen: Diese Option wird nicht unterstützt; sie wird ersetzt durch die Option Generic PDF driver des Befehls SET CURRENT PRINTER.
Hide printing progress option	Lange Ganzzahl	14	(nur Mac) Nur Wert1: 1=Fenster mit dem Druckverlauf ausblenden, 0=Fenster mit dem Druckverlauf anzeigen (Standard). Diese Option ist besonders hilfreich beim Drucken von PDF auf OS X im Hintergrund. Hinweis: Es gibt bereits eine Option Druckverlauf im Dialogfenster Einstellungen (Seite Anwendung/Optionen). Diese gilt jedoch global für die Anwendung und blendet nicht alle Fenster unter Mac OS X aus.
Page range option	Lange Ganzzahl	15	Wert1=erste Seite zum Drucken (Standardwert ist 1) und optional Wert2=letzte Seite zum Drucken (Standardwert -1 = Dokumentende)
Legacy printing layer option	Lange Ganzzahl	16	(nur 4D 64-bit Versionen für Windows) nur Wert1: 1=auf GDI basierende bisherige Druckebene für nachfolgende Druckaufträge auswählen. 0=die D2D Druckerebene verwenden (Standard) 64-bit Versionen: Selector wird nur in 4D 64-bit Versionen für Windows (Einzelplatz) unterstützt: auf anderen Plattformen wird er ignoriert. Er dient hauptsächlich dazu, damit bisherige Plug-Ins in 4D Druckaufträgen in 4D 64-bit Anwendungen drucken können.

Die hier definierte Druckoption gilt für alle Druckdokumente und wird für die Dauer der Sitzung und für die komplette 4D Anwendung beibehalten. Sie wird von den Befehlen PRINT SELECTION, PRINT RECORD, Print form und QR REPORT verwendet und für alle Druckvorgänge in 4D, inkl. Designmodus.

Hinweise:

Bei den Befehlen PRINT SELECTION, PRINT RECORD und PAGE BREAK müssen Sie den optionalen Parameter “>” verwenden. Nur so können Sie verhindern, dass die mit SET PRINT OPTION definierten Druckeinstellungen neu gesetzt werden.
Der Befehl SET PRINT OPTION unterstützt hauptsächlich PostScript Drucker. Sie können ihn auch mit anderen Druckertypen, wie PCL oder Ink verwenden, dann sind jedoch u.U. einige Optionen nicht verfügbar.

PDF Optionscode (Windows) verwenden

Damit Sie im Parameter Option einen PDF Optionscode verwenden können, müssen Sie in Ihrer 4D Umgebung den Treiber PDFCreator installiert haben. Weitere Informationen dazu finden Sie im Abschnitt Integration des Treibers PDF Creator unter Windows. Darüberhinaus müssen Sie über folgende Anweisung die Steuerung zum Drucken von PDF für 4D aktivieren:

SET PRINT OPTION(Destination option;3;fileName)

Andernfalls werden die Optionscodes ignoriert.

Der Parameter Option ist ein Wert vom Typ Text, der aus zwei miteinander kombinierten Teilen besteht: "OptionTyp:OptionName". Dieser Code wird nachfolgend beschrieben:

OptionTyp gibt an, ob Sie eine native PDF Creator Option oder eine 4D PDF Administration Option spezifizieren. Es gibt zwei Werte:
- PDFOptions = native Option
- PDFInfo = interne Option

OptionName gibt die zu setzende Option an (abhängig vom Wert OptionTyp)
- Ist OptionTyp = PDFOptions, können Sie in OptionName eine der native Optionen von PDFCreator übergeben. Die Option UseAutosave betrifft z.B. das automatische Backup. Um diese Option ändern zu können, übergeben Sie im Parameter Option "PDFOptions:UseAutosave" und im Parameter Wert1 den Wert, der verwendet werden soll. Eine ausführliche Beschreibung der native Optionen von PDFCreator finden Sie in der Dokumentation zum Treiber PDFCreator.
- Ist OptionTyp = PDFInfo, können Sie in OptionName einen der nachfolgenden Selektoren übergeben:
  - Reset print setzt den internen Wartestatus zurück, insbesondere, um aus einer unendlichen Schleife herauszukommen. In diesem Fall wird Wert1 nicht verwendet.
  - Reset standard options setzt alle Optionen von PDFCreator auf ihre Standardwerte zurück. Läuft gerade ein Druckvorgang, werden die Einstellungen nach Beenden des Druckens angewandt. In diesem Fall wird Wert1 nicht verwendet.
  - Start startet oder stoppt den Spooler von PDFCreator. Zum Stoppen übergeben Sie 0 (Null) in Wert1, zum Starten 1.
  - Reset options setzt alle Optionen, die seit Beginn der Sitzung über den Befehl SET PRINT OPTION und den Selektor PDFOptions verändert wurden, wieder zurück.
  - Version liest die aktuelle Versionsnummer des Treibers PDFCreator. Dieser Selektor ist nur mit dem Befehl GET PRINT OPTION verwendbar. Die Nummer wird im Parameter Wert1 zurückgegeben.
  - Last error liest den zuletzt vom Treiber PDFCreator zurückgegebenen Fehler. Dieser Selektor ist nur mit dem Befehl GET PRINT OPTION verwendbar. Die Fehlernummer wird im Parameter Wert1 zurückgegeben.
  - Print in progress stellt fest, ob 4D auf den Druck mit PDFCreator wartet. Dieser Selektor ist nur mit dem Befehl GET PRINT OPTION verwendbar. Wert1 gibt 1 zurück, wenn 4D auf PDFCreator wartet, sonst 0.
  - Job count findet die Anzahl der Aufträge, die in der Druckerschleife warten, heraus. Dieser Selektor ist nur mit dem Befehl GET PRINT OPTION verwendbar. Die Anzahl der Aufträge wird in Wert1 zurückgegeben.
  - Synchronous Mode setzt den Synchronisierungsmodus zwischen den von 4D gesendeten Druckanfragen und dem Treiber PDFCreator. Da 4D keine Information über den aktuellen Status eines Druckauftrags erhalten kann, der sich in der Warteschleife befindet, können Sie über diese Option die Druckausführung besser steuern, indem Sie Aufträge nur senden, wenn der Status des Treibers PDFCreator "frei" ist. In diesem Fall wird 4D mit dem Treiber synchronisiert. Übergeben Sie 0 (Null) in Wert1, wenn 4D Druckanfragen sofort senden soll (Standardeinstellung) und 1, wenn 4D synchronisiert werden und warten soll, bis der Treiber den gerade laufenden Auftrag beendet hat, ehe es einen anderen sendet.

Hinweis: Nach jedem Drucken stellt 4D automatisch wieder die vorige Einstellungen des Treibers PDFCreator her, um Überschneidungen mit anderen Programmen zu vermeiden.

Beispiel 1

Nachfolgende Methode konfiguriert den PDF Treiber, so dass alle Datensätze der Tabelle an der Stelle C:\Test_PDF_X gedruckt werden, wobei X die Sequenznummer des Datensatzes ist:

 SET CURRENT PRINTER(PDFCreator Printer Name)

  // Verwenden Sie unter Windows den von PDFCreator installierten virtuellen Drucker

 If(OK=1) // ist PDFCreator derzeit installiert

 

    ALL RECORDS([Table_1])

    For($i;1;Records in selection([Table_1]))

       SET PRINT OPTION(Destination option;3;"C:\\Test\\Test_PDF_"+String($i))

  // Zieloption 3 startet einen PDFCreator Druckauftrag

       PRINT RECORD([Table_1];*)

       NEXT RECORD([Table_1])

    End for

  // Optionen des Treibers PDFCreator zurücksetzen

    SET PRINT OPTION("PDFInfo:Reset standard options";0)

 End if

Beispiel 2

In 64-bit Versionen lässt sich der Wert von Orientation option innerhalb des gleichen Druckauftrags verändern (Sonderfall). Beachten Sie, dass die Option vor dem Befehl PAGE BREAK gesetzt werden muss:

 ALL RECORDS([People])

 PRINT SETTINGS

 If(OK=1)

    OPEN PRINTING JOB

    SET PRINT OPTION(Orientation option;1) //Hochformat

    Print form([People];"Vertical_Form")

 

    SET PRINT OPTION(Orientation option;2) //Querformat

    PAGE BREAK //muss zwingend NACH der Option aufgerufen werden

    Print form([People];"Horiz_Form")

    CLOSE PRINTING JOB

 End if

Systemvariablen und Mengen

Wurde der Befehl korrekt ausgeführt, wird die Systemvariable OK auf 1 gesetzt, sonst auf 0 (Null).

Übergeben Sie einen ungültigen Optionscode, z.B. einen Code, der vom PDFCreator nicht erkannt wird, wird OK auf 0 gesetzt.

Fehlerverwaltung

Ist der für eine Option übergebene Wert ungültig oder ist Option für den Drucker nicht verfügbar, gibt der Befehl einen Fehler zurück. Sie können ihn ausfindig machen mit einer Fehlerverwaltungsmethode, die der Befehl ON ERR CALL aufruft. Der aktuelle Wert der Option bleibt dann unverändert.

Siehe auch

Druckoptionen
GET PRINT OPTION
PRINT OPTION VALUES
SET CURRENT PRINTER