All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.eclipse.swt.printing.PrinterData Maven / Gradle / Ivy

Go to download 

/*******************************************************************************
 * Copyright (c) 2000, 2011 IBM Corporation and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.swt.printing;


import org.eclipse.swt.*;
import org.eclipse.swt.graphics.*;

/**
 * Instances of this class are descriptions of a print job
 * in terms of the printer, and the scope and type of printing
 * that is desired. For example, the number of pages and copies
 * can be specified, as well as whether or not the print job
 * should go to a file.
 * 

 * Application code does not need to explicitly release the
 * resources managed by each instance when those instances are no longer
 * required, and thus no dispose() method is provided.
 * 

 *
 * @see Printer
 * @see Printer#getPrinterList
 * @see PrintDialog#open
 * @see Printing snippets
 * @see Sample code and further information
 */

public final class PrinterData extends DeviceData {
	
	/**
	 * the printer driver
	 * On Windows systems, this is the name of the driver (often "winspool").
	 * On Mac OSX, this is the destination type ("Printer", "Fax", "File", or "Preview").
	 * On X/Window systems, this is the name of a display connection to the
	 * Xprt server (the default is ":1").
	 * On GTK+, this is the backend type name (eg. GtkPrintBackendCups).
	 */
	// TODO: note that this api is not finalized for GTK+
	public String driver;
	
	/**
	 * the name of the printer
	 * On Windows systems, this is the name of the 'device'.
	 * On Mac OSX, X/Window systems, and GTK+, this is the printer's 'name'.
	 */
	public String name;
	
	/**
	 * the scope of the print job, expressed as one of the following values:
	 * 

	 * 
ALL_PAGES

	 * 
Print all pages in the current document

	 * 
PAGE_RANGE

	 * 
Print the range of pages specified by startPage and endPage

	 * 
SELECTION

	 * 
Print the current selection

	 * 

	 */
	public int scope = ALL_PAGES;
	
	/**
	 * the start page of a page range, used when scope is PAGE_RANGE.
	 * This value can be from 1 to the maximum number of pages for the platform.
	 */
	public int startPage = 1;

	/**
	 * the end page of a page range, used when scope is PAGE_RANGE.
	 * This value can be from 1 to the maximum number of pages for the platform.
	 */
	public int endPage = 1;
	
	/**
	 * whether or not the print job should go to a file
	 */
	public boolean printToFile = false;
	
	/**
	 * the name of the file to print to if printToFile is true.
	 * Note that this field is ignored if printToFile is false.
	 */
	public String fileName;
	
	/**
	 * the number of copies to print.
	 * Note that this field may be controlled by the printer driver
	 * In other words, the printer itself may be capable of printing
	 * multiple copies, and if so, the value of this field will always be 1.
	 */
	public int copyCount = 1;
	
	/**
	 * whether or not the printer should collate the printed paper
	 * Note that this field may be controlled by the printer driver.
	 * In other words, the printer itself may be capable of doing the
	 * collation, and if so, the value of this field will always be false.
	 */
	public boolean collate = false;
	
	/**
	 * The orientation of the paper, which can be either PORTRAIT
	 * or LANDSCAPE.
	 * 
	 * @since 3.5
	 */
	public int orientation = PORTRAIT;

	/**
	 * Single-sided or double-sided printing, expressed as one of the
	 * following values:
	 * 

	 * 
SWT.DEFAULT

	 * 
the default duplex value for the printer

	 * 
DUPLEX_NONE

	 * 
single-sided printing

	 * 
DUPLEX_LONG_EDGE

	 * 
double-sided printing as if bound on the long edge

	 * 
DUPLEX_SHORT_EDGE

	 * 
double-sided printing as if bound on the short edge

	 * 

	 * 

	 * The default value is SWT.DEFAULT, meaning do not set a value;
	 * use the printer's default duplex setting.
	 * A printer's default value is typically single-sided,
	 * however it can default to double-sided in order to save paper.
	 * 

	 * 
	 * @since 3.7
	 */
	public int duplex = SWT.DEFAULT;

	/**
	 * scope field value indicating that
	 * all pages should be printed
	 */	
	public static final int ALL_PAGES = 0;
	
	/**
	 * scope field value indicating that
	 * the range of pages specified by startPage and endPage
	 * should be printed
	 */	
	public static final int PAGE_RANGE = 1;
	
	/**
	 * scope field value indicating that
	 * the current selection should be printed
	 */	
	public static final int SELECTION = 2;
		
	/**
	 * orientation field value indicating
	 * portrait paper orientation
	 * 
	 * @since 3.5
	 */
	public static final int PORTRAIT = 1;
	
	/**
	 * orientation field value indicating
	 * landscape paper orientation
	 * 
	 * @since 3.5
	 */
	public static final int LANDSCAPE = 2;
	
 	/**
	 * duplex field value indicating
	 * single-sided printing.
	 * 

	 * This is also known as simplex printing.
	 * 

	 * 
	 * @since 3.7
	 */
	public static final int DUPLEX_NONE = 0;
	
	/**
	 * duplex field value indicating
	 * double-sided printing for binding on the long edge.
	 * 

	 * For portrait orientation, the long edge is vertical.
	 * For landscape orientation, the long edge is horizontal.
	 * 

	 * This is also known as duplex printing.
	 * 

	 * 
	 * @since 3.7
	 */
	public static final int DUPLEX_LONG_EDGE = 1;
	
	/**
	 * duplex field value indicating
	 * double-sided printing for binding on the short edge.
	 * 

	 * For portrait orientation, the short edge is horizontal.
	 * For landscape orientation, the short edge is vertical.
	 * 

	 * This is also known as duplex tumble printing.
	 * 

	 * 
	 * @since 3.7
	 */
	public static final int DUPLEX_SHORT_EDGE = 2;
	
	/**
	 * private, platform-specific data
	 * On Windows, this contains a copy of the DEVMODE struct
	 * returned from the PrintDialog.
	 * On GTK, this contains a copy of the print_settings and page_setup
	 * returned from the PrintDialog.
	 * On OS X Carbon, this contains a copy of the PrintSettings and PageFormat
	 * returned from the PrintDialog.
	 * This field is not currently used on the X/Window System.
	 */	
	byte [] otherData;

	/**
	 * Constructs an instance of this class that can be
	 * used to print to the default printer.
	 * 
	 * @see Printer#getDefaultPrinterData
	 */
	public PrinterData() {
	}

	/**
	 * Constructs an instance of this class with the given
	 * printer driver and printer name.
	 *
	 * @param driver the printer driver for the printer
	 * @param name the name of the printer
	 *
	 * @see #driver
	 * @see #name
	 */
	public PrinterData(String driver, String name) {
		this.driver = driver;
		this.name = name;
	}

	/**
	 * Returns a string containing a concise, human-readable
	 * description of the receiver.
	 *
	 * @return a string representation of the receiver
	 */
	public String toString() {
		return "PrinterData {" + "driver = " + driver + ", name = " + name + "}";  //$NON-NLS-1$ //$NON-NLS-2$ //$NON-NLS-3$ //$NON-NLS-4$
	}
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy