Version 2003
SET PRINT OPTION (Option; Wert1{; Wert2})
| Parameter | Typ | Beschreibung | |
| Option | Lange Ganzzahl | Optionsnummer | |
| Wert1 | Lange GZ | String | Wert 1 der Option | |
| Wert2 | Lange Ganzzahl | 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 >.
Der Parameter Option gibt die zu verändernde Option an. Sie können einen Wert oder eine vordefinierte Konstante unter dem Thema "Druckoptionen" übergeben:
| Option () | Wert1 | Wert2 |
| 1 (Paper option) | Name | - |
| Höhe | Breite | |
| 2 (Orientation option) | 1=Porträt, 2=Landschaft | - |
| 3 (Scale option) | Numerisch (%) | - |
| 4 (Number of copies option) | Numerisch | - |
| 5 (Paper source option) | Nur Windows | |
| Index (Numerisch) | - | |
| 8 (Color option) | Nur Windows | |
| 1=S/W, 2=Farbe | - | |
| 9 (Destination option) | 1=Drucker, | - |
| 2=Datei (PC)/PS (Mac), | Zugriffspfad | |
| 3=PDF (Mac), | Zugriffspfad | |
| 4=EPS (Mac) | Zugriffspfad | |
| 11 (Double sided option) | Nur Windows | |
| 0=Einseitig (Standard) | - | |
| 1=Doppelseitig | Bindung: 0=Links | |
| (Standard), 1=Oben | ||
| 12 (Spooler document name option) | Name des zu | - |
| druckenden Dokuments |
Paper option (1): Die Liste der verfügbaren Papiernamen erhalten Sie über den Befehl PRINT OPTION VALUES.
Sie können den Papiernamen entweder in Wert1 (ohne Wert2) übergeben, oder die Papierhöhe in Wert1, die Breite in Wert2 übergeben. Die Werte müssen in Pixel auf dem Bildschirm angegeben werden.
Orientation option (2): Übergeben Sie in Wert1 entweder 1 (Porträt), oder 2 (Landschaft).
Scale option (3): Übergeben Sie in Wert1 einen Prozentsatz. 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 (4): Übergeben Sie in Wert1 die Anzahl der zu druckenden Kopien.
Paper source option (5): Übergeben Sie Nummer, die dem Index des zu verwendenden Papierschachts entspricht. Über den Befehl PRINT OPTION VALUES erhalten Sie das Array mit den Namen.
Hinweis: Diese Option ist nur unter Windows verwendbar.
Color option (8): Übergeben Sie in Wert1 den Code für die Farbe: 1=schwarz/weiß (monochrome), 2=Farbe.
Hinweis: Diese Option ist nur unter Windows verwendbar.
Destination option (9): Übergeben Sie in Wert1 den Code für die Druckausgabe: 1=Drucker, 2= Datei (PC)/PS (Mac), 3= PDF Datei (nur MacOS), 4=EPS Datei (nur MacOS).
Bei Wert1 ungleich 1 übergeben Sie in Wert2 den vollständigen Pfad des sich ergebenden Dokuments. Dieser Pfad wird benützt, bis ein anderer Pfad angegeben wird. Gibt es bereits eine gleichnamige Datei am Zielort, wird sie ersetzt. Übergeben Sie in Wert2 einen leeren String oder lassen diesen Parameter (unter Windows) weg, erscheint beim Drucken ein Sichern-Dialog.
Hinweis: Diese Option ist unter MacOS 9 nicht verfügbar.
Double sided option (11): In Wert1 übergeben Sie 0 (Einseitig oder Standard) oder 1 (Doppelseitig).
Ist Wert1 gleich 1, können Sie in Wert2 die Bindung angeben: 0=Bindung links (Standard), 1=Bindung oben.
Hinweis: Diese Option ist nur unter Windows verwendbar.
Spooler document name option (12): In Wert1 übergeben Sie den Namen des Druckdokuments, das in der Dokumentenliste des Druck-Servers erscheinen muß.
Um die Standardoperation wiederherzustellen (Methodenname statt Methode, Tabellenname für Datensatz, etc.), übergeben Sie in Wert1 einen leeren String.
Warnung: Der hier definierte Name gilt für alle Druckdokumente der Sitzung, bis ein neuer Name oder ein leerer String übergeben werden.
Ist die Option Spooler document name option (12) definiert, wird während der gesamten Sitzung und für die komplette 4D Anwendung eine Druckoption beibehalten. Sie wird von den Befehlen PRINT SELECTION, PRINT LABEL, PRINT RECORD, Print form und QR REPORT verwendet und für alle Druckvorgänge in 4th Dimension, inkl. Designmodus.
Allgemein
Mit den Befehlen PRINT SELECTION, PRINT LABEL, PRINT RECORD und Print form und QR REPORT müssen Sie den optionalen Parameter ">" verwenden. Nur so können Sie verhindern, dass die mit SET PRINT OPTION definierten Druckeinstellungen neu gesetzt werden.
Hinweis: Der Befehl GET PRINT OPTION funktioniert nur mit PostScript Druckern.
Referenz
GET PRINT OPTION, PRINT OPTION VALUES, SET CURRENT PRINTER.
Systemvariablen oder Mengen
Wurde der Befehl korrekt ausgeführt, wird die Systemvariable OK auf 1 gesetzt, sonst auf 0 (Null).
Fehler verwalten
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.
Konstanten
Thema Druckoptionen.