Lade...
 

CX_PRINTER_MANAGER::SelectPrinterWithPresets

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:
Var(printer, printerProperties, pageProperties)

// 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
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)