Version 2004
WR SET PRINT OPTION (Bereich; Option; Wert1{; Wert2{; Wert3}})
| Parameter | Typ | Beschreibung | |
| Bereich | Lange Ganzzahl | 4D Write Bereich | |
| Option | Lange Ganzzahl | Optionsnummer | |
| Wert1 | Numerisch | Wert 1 der Option | |
| Wert2 | Numerisch | Wert 2 der Option | |
| Wert3 | String | Wert 3 der Option |
Beschreibung
Der Befehl WR SET PRINT OPTION verändert per Programmierung den Wert einer Druckoption für den in Bereich definierten 4D Write Bereich. Jede über diesen Befehl definierte Option wird auf den 4D Write Bereich angewandt, bis dieser Bereich aufgehoben wird. Optionen, wie z.B. Ausrichtung, die in der Regel mit 4D Write Dokumenten gesichert werden, werden ebenfalls gesichert.
Die aktuellen Druckparameter von 4th Dimension sowie anderer 4D Write Bereiche werden nicht verändert.
Über den Parameter Option können Sie die zu ändernde Option angeben. Sie können entweder einen Wert oder eine der vordefinierten Konstanten unter dem neuen Thema "WR Druckoptionen" verwenden.
In Wert1 übergeben Sie den bzw. die neuen Werte von Option und (optional) die Parameter Wert2 und Wert3. Zahl und Art der zu übergebenden Werte richten sich nach dem in Option angegebenen Wert.
Weitere Informationen über Optionen und ihre Werte finden Sie in der folgenden Übersicht:
| Option (Konstante) | Wert1 | Wert2 | Wert3 |
| 1 (wr paper option) | Höhe | Breite | - |
| 0 | 0 | Name | |
| 2 (wr orientation option) | 1=Querformat | ||
| 2=Hochformat | - | - | |
| 3 (wr scale option) | Zahl (%) | - | - |
| 4 (wr number of copies option) | Zahl | - | - |
| 5 (wr paper source option) | nur Windows: | ||
| Index (Zahl) | - | - | |
| 6 (wr pages from option) | Zahl (1=Standard) | - | - |
| 7 (wr pages to option) | Zahl (1=Standard, | - | - |
| Dokumentende) | |||
| 8 (wr color option) | 1=S/W, 2=Farbe | - | - |
| 9 (wr destination option) | 1=Drucker | 0 | - |
| 2=Datei (PC)/PS (Mac) | 0 | Zugriffspfad | |
| 3=PDF (Mac) | 0 | Zugriffspfad | |
| 11 (wr double sided option) | nur Windows: | ||
| 0=Einseitig (Standard) | - | - | |
| 1=Doppelseitig | Bindung: 0=Links | - | |
| (Standard), 1=Oben | |||
| 12 (wr spooler document | 0 | 0 | Name des |
| name option) | Dokuments |
wr paper option (1): Die Liste mit den verfügbaren Papiernamen erhalten Sie über den 4D Befehl PRINT OPTION VALUES.
Sie übergeben entweder den Papiernamen in Wert3 (in diesem Fall übergeben Sie 0 in Wert1 und Wert2), oder die Papierhöhe in Wert1 und die Papierbreite in Wert2. Breite und Höhe müssen in Pixel auf dem Bildschirm angegeben werden.
wr orientation option (2): Sie übergeben in Wert1 entweder 1 (Querformat) oder 2 (Hochformat).
wr scale option (3): Sie übergeben in Wert1 einen Prozentwert. Beachten Sie, dass einige Drucker keine Anderung an der Skalierung zulassen. Bei einem ungültigen Wert wird die Eigenschaft beim Drucken auf 100% zurückgesetzt.
wr number of copies option (4): Sie übergeben in Wert1 die Anzahl der zu druckenden Kopien.
Hinweis: Diese Option ist nur unter Windows verfügbar.
wr paper source option (5): Sie übergeben die Nummer des gewünschten Papierschachtes aus dem Index des Array mit den Papierschachtnummern, die der 4D Befehl PRINT OPTION VALUES zurückgibt.
Hinweis: Diese Option ist nur unter Windows verfügbar.
wr pages from option (6): Sie übergeben in Wert1 die Nummer der Seite, auf welcher der Druck starten soll. Der Standardwert ist 1.
wr pages to option (7): Sie übergeben in Wert1 die Nummer der letzten Seite, die gedruckt werden soll. Übergeben Sie -1, wird das gesamte Dokument gedruckt (-1 ist dasselbe wie Übergang zur letzten Seite des Dokuments).
wr color option (8): Sie übergeben in Wert1 den Code für den Farbmodus: 1=Schwarz/Weiss (einfarbig), 2=Farbe.
Hinweis: Diese Option ist nur unter Windows verfügbar.
wr destination option (9): Sie übergeben in Wert1 den Code für die Art der Druckausgabe: 1=Drucker, 2=Datei (PC)/PS (Mac), 3= PDF Datei (nur MacOS).
In Wert2 übergeben Sie immer 0.
Unterscheidet sich Wert1 von 1, übergeben Sie den Zugriffspfad für das sich ergebende Dokument in Wert3. Dieser Pfad wird benutzt, bis ein anderer Pfad angegeben wird. Gibt es am Zielort bereits eine Datei mit demselben Namen, wird sie ersetzt.
Nur unter Windows gilt: Übergeben Sie einen leeren String in Wert3 oder geben Sie diesen Parameter nicht an, erscheint beim Drucken ein Sichern-Dialog. Schlägt die Operation fehl, werden die Druckereinstellungen (1) angewendet
Hinweis: Diese Option ist nur unter Windows verfügbar.
wr double sided option (11): Sie übergeben in Wert1 entweder 0 (Einseitig oder Standard) oder 1 (Doppelseitig).
Bei Wert1 gleich 1 können Sie in Wert2 eine Bindungsart definieren: 0=Bindung links (Standardwert), 1=Bindung oben.
Hinweis: Diese Option ist nur unter Windows verfügbar.
wr spooler document name option (12): Sie übergeben in Wert3 den Namen des Druckdokuments, das in der Liste der Spooler Dokumente erscheinen soll. Übergeben Sie 0 in Wert1 und Wert2.
Um die Standardoperation zu verwenden oder wiederherzustellen (Methodenname anstatt einer Methode verwenden, Tabellenname für einen Datensatz, etc.), übergeben Sie in Wert3 einen leeren String.
Warnung: Der durch diese Anweisung definierte Name wird für alle Druckdokumente der Sitzung verwendet, solange kein anderer Name bzw. kein leerer String übergeben wird.
Ist der in Option übergebene Wert ungültig oder am Drucker nicht verfügbar, gibt der Befehl einen Fehler zurück und der aktuelle Wert in Option bleibt unverändert. Sie können den Fehler mit einer Fehlerverwaltungsmethode, installiert durch den Befehl WR ON ERROR abfangen. Die Systemvariable OK wird auf 1 gesetzt, wenn der Befehl korrekt ausgeführt wurde, sonst auf 0 (Null).
Referenz
PRINT OPTION VALUES, WR GET PRINT OPTION.