SpoolPrinter class (com.iscobol.rts.print.SpoolPrinter) and the Print Preview

The isCOBOL Framework provides the ability to obtain a print preview.

This feature is applicable to all print files. In order to obtain a print preview you need to define the file as follows:

SELECT print-prev ASSIGN TO PRINT "-P PREVIEW"        ORGANIZATION LINE SEQUENTIAL.

The preview dialog will show up when the print file is closed.

The tool-bar on top of the dialog allows you to:

•	save the job as PDF file

•	print the job with a physical printer

•	close the dialog

•	find text (available also by pressing CTRL+F)

•	navigate through pages (if the job contains more than one page)

•	zoom in and out for better reading

•	apply aliasing on the text for better reading

•	maximize and restore the window

The dialog title can be set through the configuration property iscobol.print.preview.title.

The dialog icon can be changed through the configuration property iscobol.print.preview.icon.

The com.iscobol.rts.print.SpoolPrinter class

The print preview dialog can be customized by calling methods of the internal factory class com.iscobol.rts.print.SpoolPrinter. These methods must be called before the print file is closed. The following table shows the javadoc of the existing methods.

static String	getDialogTitle() Returns the title of the preview window
static javax.swing.ImageIcon	getImageIcon() Returns the current icon shown in the preview dialog title bar
static java.awt.Point	getPreviewLocation() Returns the location in pixels of the preview dialog
static double	getPreviewScale() Returns the current scale
static java.awt.Dimension	getPreviewSize() Returns the size in pixels of the preview dialog
static String	getSaveDefaultDirectory() Returns the directory proposed by the Save As dialog
static String	getSaveDefaultFilename() Returns the file name proposed by the Save As dialog
static boolean	isPreviewAliasing() Returns the status of the Aliasing button
static boolean	isPreviewMaximized() Returns if the preview dialog is maximized
static boolean	isShowPrintButton() Returns if the Print button is visible or not in the tool-bar
static boolean	isShowPrintDialog() Returns if the Printer Setup dialog must be shown before printing
static boolean	isShowPrintSetupButton() Returns if the Print Setup button is visible or not in the tool-bar
static boolean	isShowSaveButton() Returns if the Save button is visible or not in the tool-bar
static void	setDialogTitle(String title) Sets the title of the preview window
static void	setImageIcon(static javax.swing.ImageIcon) Sets the icon to show in the preview dialog title bar
static void	setPreviewAliasing(boolean aliasing) Sets the status of the Aliasing button
static void	setPreviewLocation(int x, int y) Sets the location in pixels of the preview dialog
static void	setPreviewMaximized(boolean maximize) Choose if the preview dialog must be maximized or not
static void	setPreviewScale(double scale) Sets the current scale
static void	setPreviewSize(int width, int height) Sets the size in pixels for the print preview dialog
static void	setSaveDefaultDirectory(String path) Sets the directory proposed by the Save As dialog
static void	setSaveDefaultFilename(String name) Sets the file name proposed by the Save As dialog
static void	setShowPrintButton(boolean showPrintButton) Sets the visibility of the Print button in the tool-bar
static void	setShowPrintDialog(boolean showPrintDialog) Choose if the Printer Setup dialog must be shown before printing
static void	setShowPrintSetupButton(boolean showPrintSetupButton) Sets the visibility of the Print Setup button in the tool-bar
static void	setShowSaveButton(boolean showSaveButton) Sets the visibility of the Save button in the tool-bar

The following sample shows how to make the preview dialog appear with the zoom set to 50%:

CONFIGURATION SECTION. REPOSITORY.     class is-spoolprinter as "com.iscobol.rts.print.SpoolPrinter"               . INPUT-OUTPUT SECTION. FILE-CONTROL.     select print-job assign to printer "-P PREVIEW"            organization line sequential.   FILE SECTION. FD  print-job. 01  print-record pic x(83).        PROCEDURE DIVISION. main.      open output print-job.     write print-record from "test zoom".     is-spoolprinter:>setPreviewScale(50 as double).     close print-job.     goback.

Thin Client

In a Thin Client environment, print jobs are managed client side so the print preview dialog must be configured and invoked client side. In order to invoke com.iscobol.rts.print.SpoolPrinter methods client side, you can rely on the CobolGUIJavaBean Class (com.iscobol.gui.server.CobolGUIJavaBean).

The following sample shows how to make the preview dialog appear client side with the zoom set to 50%:

CONFIGURATION SECTION. REPOSITORY.     class is-java-bean as "com.iscobol.gui.server.CobolGUIJavaBean"     class j-double     as "java.lang.Double"               . INPUT-OUTPUT SECTION. FILE-CONTROL.     select print-job assign to printer "-P PREVIEW"            organization line sequential.   FILE SECTION. FD  print-job. 01  print-record pic x(83).   PROCEDURE DIVISION. main.      open output print-job.     write print-record from "test zoom".     is-java-bean:>callStaticMethod("com.iscobol.rts.print.SpoolPrinter", "setPreviewScale", j-double:>new(50 as double)).     close print-job.     goback.

Note - The com.iscobol.preview.PreviewDialogSettings JavaBean has been deprecated. It’s still supported for backward compatibility but it lacks of the latest methods implemented in com.iscobol.rts.print.SpoolPrinter.