CX_PRINTER_MANAGER::SelectPrinterWithPresets
Beschreibung:
Diese Funktion zeigt ein mit den übergebenen Parametern initialisierten Printer-Setup-Dialog und liefert die vom Benutzer getroffene Druckereinstellungen zurück.
Als Parameter erwartet die Funktion drei Objekte: Ein CX_PRINTER-Objekt, ein CX_PRINTER_PROPERTIES-Objekt und ein CX_PAGE_PROPERTIES-Objekt. Die Funktion kann auch mit NULL-Objekten aufgerufen werden, in diesem Fall werden die Standardwerte angezeigt.
Zurückgegeben werden drei transiente Objekte in einem Vektor, die den ausgewählten Drucker (CX_PRINTER) und dessen Eigenschaften (CX_PRINTER_PROPERTIES) sowie das ausgewählte
Papierformat (CX_PAGE_PROPERTIES) enthalten.Bricht der Benutzer den Auswahldialog ab wird ein leerer Vector zurückgegeben. Dies kann mit Cardinality abgefragt werden.
Diese Funktion ändert keinerlei Einstellungen, insbesondere wird nicht der Standarddrucker gesetzt. Sollen die ausgewählten Drucker und Eigenschaften verwendet werden müssen die Objekte beispielsweise für ein Dokument explizit mit Funktionen von CXS_DOCUMENT gesetzt werden. Zur Auswahl und zum Setzen des Standarddruckers muss der Befehl SetPrinter verwendet
werden.Code-Beispiel:
// Preset the dialog with landscape paper-format:
CreateTransObject(CX_PAGE_PROPERTIES) -> pageProperties
2 pageProperties Put(paperOrientation)
NULL NULL
pageProperties GetManager(PRINTER) Call(SelectPrinterWithPresets) # Dup Cardinality ifnot { Drop return
}
0 Over
GetElement -> printer 1 Over GetElement -> printerProperties 2 Swap
GetElement -> pageProperties// double number of copies:
printerProperties Copy(copies) 2 * printerProperties Put(copies)
// Show changed values to the user:
printer printerProperties pageProperties GetManager(PRINTER) Call(SelectPrinterWithPresets)
Stack | Positionen | Objekttyp | Kurzbeschreibung |
---|---|---|---|
Stack(In) | Top | CX_PRINTER_MANAGER | Druckermanager |
Top-1 | CX_PAGE_PROPERTIES | Seiteneinstellungen | |
Top-2 | CX_PRINTER_PROPERTIES | Druckereinstellungen | |
Top-3 | CX_PRINTER | Drucker | |
Stack(Out) | Top | ] | |
Top-1 | CX_PAGE_PROPERTIES | Seiteneinstellungen | |
Top-2 | CX_PRINTER_PROPERTIES | Druckereinstellungen | |
Top-3 | CX_PRINTER | gewählter Drucker | |
Top-4 | [ |
Funktionsaufruf: Call(SelectPrinterWithPresets)