Back to index...

	/*
	* Copyright (c) 1999, 2013, Oracle and/or its affiliates. All rights reserved.
	* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
	*
	* This code is free software; you can redistribute it and/or modify it
	* under the terms of the GNU General Public License version 2 only, as
	* published by the Free Software Foundation. Oracle designates this
	* particular file as subject to the "Classpath" exception as provided
	* by Oracle in the LICENSE file that accompanied this code.
	*
	* This code is distributed in the hope that it will be useful, but WITHOUT
	* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
	* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
	* version 2 for more details (a copy is included in the LICENSE file that
	* accompanied this code).
	*
	* You should have received a copy of the GNU General Public License version
	* 2 along with this work; if not, write to the Free Software Foundation,
	* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
	*
	* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
	* or visit www.oracle.com if you need additional information or have any
	* questions.
	*/

	package java.awt;

	import java.util.Locale;

	/**
	* A set of attributes which control the output of a printed page.
	* <p>
	* Instances of this class control the color state, paper size (media type),
	* orientation, logical origin, print quality, and resolution of every
	* page which uses the instance. Attribute names are compliant with the
	* Internet Printing Protocol (IPP) 1.1 where possible. Attribute values
	* are partially compliant where possible.
	* <p>
	* To use a method which takes an inner class type, pass a reference to
	* one of the constant fields of the inner class. Client code cannot create
	* new instances of the inner class types because none of those classes
	* has a public constructor. For example, to set the color state to
	* monochrome, use the following code:
	* <pre>
	* import java.awt.PageAttributes;
	*
	* public class MonochromeExample {
	* public void setMonochrome(PageAttributes pageAttributes) {
	* pageAttributes.setColor(PageAttributes.ColorType.MONOCHROME);
	* }
	* }
	* </pre>
	* <p>
	* Every IPP attribute which supports an <i>attributeName</i>-default value
	* has a corresponding <code>set<i>attributeName</i>ToDefault</code> method.
	* Default value fields are not provided.
	*
	* @author David Mendenhall
	* @since 1.3
	*/
	public final class PageAttributes implements Cloneable {
	/**
	* A type-safe enumeration of possible color states.
	* @since 1.3
	*/
	public static final class ColorType extends AttributeValue {
	private static final int I_COLOR = 0;
	private static final int I_MONOCHROME = 1;

	private static final String NAMES[] = {
	"color", "monochrome"
	};

	/**
	* The ColorType instance to use for specifying color printing.
	*/
	public static final ColorType COLOR = new ColorType(I_COLOR);
	/**
	* The ColorType instance to use for specifying monochrome printing.
	*/
	public static final ColorType MONOCHROME = new ColorType(I_MONOCHROME);

	private ColorType(int type) {
	super(type, NAMES);
	}
	}

	/**
	* A type-safe enumeration of possible paper sizes. These sizes are in
	* compliance with IPP 1.1.
	* @since 1.3
	*/
	public static final class MediaType extends AttributeValue {
	private static final int I_ISO_4A0 = 0;
	private static final int I_ISO_2A0 = 1;
	private static final int I_ISO_A0 = 2;
	private static final int I_ISO_A1 = 3;
	private static final int I_ISO_A2 = 4;
	private static final int I_ISO_A3 = 5;
	private static final int I_ISO_A4 = 6;
	private static final int I_ISO_A5 = 7;
	private static final int I_ISO_A6 = 8;
	private static final int I_ISO_A7 = 9;
	private static final int I_ISO_A8 = 10;
	private static final int I_ISO_A9 = 11;
	private static final int I_ISO_A10 = 12;
	private static final int I_ISO_B0 = 13;
	private static final int I_ISO_B1 = 14;
	private static final int I_ISO_B2 = 15;
	private static final int I_ISO_B3 = 16;
	private static final int I_ISO_B4 = 17;
	private static final int I_ISO_B5 = 18;
	private static final int I_ISO_B6 = 19;
	private static final int I_ISO_B7 = 20;
	private static final int I_ISO_B8 = 21;
	private static final int I_ISO_B9 = 22;
	private static final int I_ISO_B10 = 23;
	private static final int I_JIS_B0 = 24;
	private static final int I_JIS_B1 = 25;
	private static final int I_JIS_B2 = 26;
	private static final int I_JIS_B3 = 27;
	private static final int I_JIS_B4 = 28;
	private static final int I_JIS_B5 = 29;
	private static final int I_JIS_B6 = 30;
	private static final int I_JIS_B7 = 31;
	private static final int I_JIS_B8 = 32;
	private static final int I_JIS_B9 = 33;
	private static final int I_JIS_B10 = 34;
	private static final int I_ISO_C0 = 35;
	private static final int I_ISO_C1 = 36;
	private static final int I_ISO_C2 = 37;
	private static final int I_ISO_C3 = 38;
	private static final int I_ISO_C4 = 39;
	private static final int I_ISO_C5 = 40;
	private static final int I_ISO_C6 = 41;
	private static final int I_ISO_C7 = 42;
	private static final int I_ISO_C8 = 43;
	private static final int I_ISO_C9 = 44;
	private static final int I_ISO_C10 = 45;
	private static final int I_ISO_DESIGNATED_LONG = 46;
	private static final int I_EXECUTIVE = 47;
	private static final int I_FOLIO = 48;
	private static final int I_INVOICE = 49;
	private static final int I_LEDGER = 50;
	private static final int I_NA_LETTER = 51;
	private static final int I_NA_LEGAL = 52;
	private static final int I_QUARTO = 53;
	private static final int I_A = 54;
	private static final int I_B = 55;
	private static final int I_C = 56;
	private static final int I_D = 57;
	private static final int I_E = 58;
	private static final int I_NA_10X15_ENVELOPE = 59;
	private static final int I_NA_10X14_ENVELOPE = 60;
	private static final int I_NA_10X13_ENVELOPE = 61;
	private static final int I_NA_9X12_ENVELOPE = 62;
	private static final int I_NA_9X11_ENVELOPE = 63;
	private static final int I_NA_7X9_ENVELOPE = 64;
	private static final int I_NA_6X9_ENVELOPE = 65;
	private static final int I_NA_NUMBER_9_ENVELOPE = 66;
	private static final int I_NA_NUMBER_10_ENVELOPE = 67;
	private static final int I_NA_NUMBER_11_ENVELOPE = 68;
	private static final int I_NA_NUMBER_12_ENVELOPE = 69;
	private static final int I_NA_NUMBER_14_ENVELOPE = 70;
	private static final int I_INVITE_ENVELOPE = 71;
	private static final int I_ITALY_ENVELOPE = 72;
	private static final int I_MONARCH_ENVELOPE = 73;
	private static final int I_PERSONAL_ENVELOPE = 74;

	private static final String NAMES[] = {
	"iso-4a0", "iso-2a0", "iso-a0", "iso-a1", "iso-a2", "iso-a3",
	"iso-a4", "iso-a5", "iso-a6", "iso-a7", "iso-a8", "iso-a9",
	"iso-a10", "iso-b0", "iso-b1", "iso-b2", "iso-b3", "iso-b4",
	"iso-b5", "iso-b6", "iso-b7", "iso-b8", "iso-b9", "iso-b10",
	"jis-b0", "jis-b1", "jis-b2", "jis-b3", "jis-b4", "jis-b5",
	"jis-b6", "jis-b7", "jis-b8", "jis-b9", "jis-b10", "iso-c0",
	"iso-c1", "iso-c2", "iso-c3", "iso-c4", "iso-c5", "iso-c6",
	"iso-c7", "iso-c8", "iso-c9", "iso-c10", "iso-designated-long",
	"executive", "folio", "invoice", "ledger", "na-letter", "na-legal",
	"quarto", "a", "b", "c", "d", "e", "na-10x15-envelope",
	"na-10x14-envelope", "na-10x13-envelope", "na-9x12-envelope",
	"na-9x11-envelope", "na-7x9-envelope", "na-6x9-envelope",
	"na-number-9-envelope", "na-number-10-envelope",
	"na-number-11-envelope", "na-number-12-envelope",
	"na-number-14-envelope", "invite-envelope", "italy-envelope",
	"monarch-envelope", "personal-envelope"
	};

	/**
	* The MediaType instance for ISO/DIN and JIS 4A0, 1682 x 2378 mm.
	*/
	public static final MediaType ISO_4A0 = new MediaType(I_ISO_4A0);
	/**
	* The MediaType instance for ISO/DIN and JIS 2A0, 1189 x 1682 mm.
	*/
	public static final MediaType ISO_2A0 = new MediaType(I_ISO_2A0);
	/**
	* The MediaType instance for ISO/DIN and JIS A0, 841 x 1189 mm.
	*/
	public static final MediaType ISO_A0 = new MediaType(I_ISO_A0);
	/**
	* The MediaType instance for ISO/DIN and JIS A1, 594 x 841 mm.
	*/
	public static final MediaType ISO_A1 = new MediaType(I_ISO_A1);
	/**
	* The MediaType instance for ISO/DIN and JIS A2, 420 x 594 mm.
	*/
	public static final MediaType ISO_A2 = new MediaType(I_ISO_A2);
	/**
	* The MediaType instance for ISO/DIN and JIS A3, 297 x 420 mm.
	*/
	public static final MediaType ISO_A3 = new MediaType(I_ISO_A3);
	/**
	* The MediaType instance for ISO/DIN and JIS A4, 210 x 297 mm.
	*/
	public static final MediaType ISO_A4 = new MediaType(I_ISO_A4);
	/**
	* The MediaType instance for ISO/DIN and JIS A5, 148 x 210 mm.
	*/
	public static final MediaType ISO_A5 = new MediaType(I_ISO_A5);
	/**
	* The MediaType instance for ISO/DIN and JIS A6, 105 x 148 mm.
	*/
	public static final MediaType ISO_A6 = new MediaType(I_ISO_A6);
	/**
	* The MediaType instance for ISO/DIN and JIS A7, 74 x 105 mm.
	*/
	public static final MediaType ISO_A7 = new MediaType(I_ISO_A7);
	/**
	* The MediaType instance for ISO/DIN and JIS A8, 52 x 74 mm.
	*/
	public static final MediaType ISO_A8 = new MediaType(I_ISO_A8);
	/**
	* The MediaType instance for ISO/DIN and JIS A9, 37 x 52 mm.
	*/
	public static final MediaType ISO_A9 = new MediaType(I_ISO_A9);
	/**
	* The MediaType instance for ISO/DIN and JIS A10, 26 x 37 mm.
	*/
	public static final MediaType ISO_A10 = new MediaType(I_ISO_A10);
	/**
	* The MediaType instance for ISO/DIN B0, 1000 x 1414 mm.
	*/
	public static final MediaType ISO_B0 = new MediaType(I_ISO_B0);
	/**
	* The MediaType instance for ISO/DIN B1, 707 x 1000 mm.
	*/
	public static final MediaType ISO_B1 = new MediaType(I_ISO_B1);
	/**
	* The MediaType instance for ISO/DIN B2, 500 x 707 mm.
	*/
	public static final MediaType ISO_B2 = new MediaType(I_ISO_B2);
	/**
	* The MediaType instance for ISO/DIN B3, 353 x 500 mm.
	*/
	public static final MediaType ISO_B3 = new MediaType(I_ISO_B3);
	/**
	* The MediaType instance for ISO/DIN B4, 250 x 353 mm.
	*/
	public static final MediaType ISO_B4 = new MediaType(I_ISO_B4);
	/**
	* The MediaType instance for ISO/DIN B5, 176 x 250 mm.
	*/
	public static final MediaType ISO_B5 = new MediaType(I_ISO_B5);
	/**
	* The MediaType instance for ISO/DIN B6, 125 x 176 mm.
	*/
	public static final MediaType ISO_B6 = new MediaType(I_ISO_B6);
	/**
	* The MediaType instance for ISO/DIN B7, 88 x 125 mm.
	*/
	public static final MediaType ISO_B7 = new MediaType(I_ISO_B7);
	/**
	* The MediaType instance for ISO/DIN B8, 62 x 88 mm.
	*/
	public static final MediaType ISO_B8 = new MediaType(I_ISO_B8);
	/**
	* The MediaType instance for ISO/DIN B9, 44 x 62 mm.
	*/
	public static final MediaType ISO_B9 = new MediaType(I_ISO_B9);
	/**
	* The MediaType instance for ISO/DIN B10, 31 x 44 mm.
	*/
	public static final MediaType ISO_B10 = new MediaType(I_ISO_B10);
	/**
	* The MediaType instance for JIS B0, 1030 x 1456 mm.
	*/
	public static final MediaType JIS_B0 = new MediaType(I_JIS_B0);
	/**
	* The MediaType instance for JIS B1, 728 x 1030 mm.
	*/
	public static final MediaType JIS_B1 = new MediaType(I_JIS_B1);
	/**
	* The MediaType instance for JIS B2, 515 x 728 mm.
	*/
	public static final MediaType JIS_B2 = new MediaType(I_JIS_B2);
	/**
	* The MediaType instance for JIS B3, 364 x 515 mm.
	*/
	public static final MediaType JIS_B3 = new MediaType(I_JIS_B3);
	/**
	* The MediaType instance for JIS B4, 257 x 364 mm.
	*/
	public static final MediaType JIS_B4 = new MediaType(I_JIS_B4);
	/**
	* The MediaType instance for JIS B5, 182 x 257 mm.
	*/
	public static final MediaType JIS_B5 = new MediaType(I_JIS_B5);
	/**
	* The MediaType instance for JIS B6, 128 x 182 mm.
	*/
	public static final MediaType JIS_B6 = new MediaType(I_JIS_B6);
	/**
	* The MediaType instance for JIS B7, 91 x 128 mm.
	*/
	public static final MediaType JIS_B7 = new MediaType(I_JIS_B7);
	/**
	* The MediaType instance for JIS B8, 64 x 91 mm.
	*/
	public static final MediaType JIS_B8 = new MediaType(I_JIS_B8);
	/**
	* The MediaType instance for JIS B9, 45 x 64 mm.
	*/
	public static final MediaType JIS_B9 = new MediaType(I_JIS_B9);
	/**
	* The MediaType instance for JIS B10, 32 x 45 mm.
	*/
	public static final MediaType JIS_B10 = new MediaType(I_JIS_B10);
	/**
	* The MediaType instance for ISO/DIN C0, 917 x 1297 mm.
	*/
	public static final MediaType ISO_C0 = new MediaType(I_ISO_C0);
	/**
	* The MediaType instance for ISO/DIN C1, 648 x 917 mm.
	*/
	public static final MediaType ISO_C1 = new MediaType(I_ISO_C1);
	/**
	* The MediaType instance for ISO/DIN C2, 458 x 648 mm.
	*/
	public static final MediaType ISO_C2 = new MediaType(I_ISO_C2);
	/**
	* The MediaType instance for ISO/DIN C3, 324 x 458 mm.
	*/
	public static final MediaType ISO_C3 = new MediaType(I_ISO_C3);
	/**
	* The MediaType instance for ISO/DIN C4, 229 x 324 mm.
	*/
	public static final MediaType ISO_C4 = new MediaType(I_ISO_C4);
	/**
	* The MediaType instance for ISO/DIN C5, 162 x 229 mm.
	*/
	public static final MediaType ISO_C5 = new MediaType(I_ISO_C5);
	/**
	* The MediaType instance for ISO/DIN C6, 114 x 162 mm.
	*/
	public static final MediaType ISO_C6 = new MediaType(I_ISO_C6);
	/**
	* The MediaType instance for ISO/DIN C7, 81 x 114 mm.
	*/
	public static final MediaType ISO_C7 = new MediaType(I_ISO_C7);
	/**
	* The MediaType instance for ISO/DIN C8, 57 x 81 mm.
	*/
	public static final MediaType ISO_C8 = new MediaType(I_ISO_C8);
	/**
	* The MediaType instance for ISO/DIN C9, 40 x 57 mm.
	*/
	public static final MediaType ISO_C9 = new MediaType(I_ISO_C9);
	/**
	* The MediaType instance for ISO/DIN C10, 28 x 40 mm.
	*/
	public static final MediaType ISO_C10 = new MediaType(I_ISO_C10);
	/**
	* The MediaType instance for ISO Designated Long, 110 x 220 mm.
	*/
	public static final MediaType ISO_DESIGNATED_LONG =
	new MediaType(I_ISO_DESIGNATED_LONG);
	/**
	* The MediaType instance for Executive, 7 1/4 x 10 1/2 in.
	*/
	public static final MediaType EXECUTIVE = new MediaType(I_EXECUTIVE);
	/**
	* The MediaType instance for Folio, 8 1/2 x 13 in.
	*/
	public static final MediaType FOLIO = new MediaType(I_FOLIO);
	/**
	* The MediaType instance for Invoice, 5 1/2 x 8 1/2 in.
	*/
	public static final MediaType INVOICE = new MediaType(I_INVOICE);
	/**
	* The MediaType instance for Ledger, 11 x 17 in.
	*/
	public static final MediaType LEDGER = new MediaType(I_LEDGER);
	/**
	* The MediaType instance for North American Letter, 8 1/2 x 11 in.
	*/
	public static final MediaType NA_LETTER = new MediaType(I_NA_LETTER);
	/**
	* The MediaType instance for North American Legal, 8 1/2 x 14 in.
	*/
	public static final MediaType NA_LEGAL = new MediaType(I_NA_LEGAL);
	/**
	* The MediaType instance for Quarto, 215 x 275 mm.
	*/
	public static final MediaType QUARTO = new MediaType(I_QUARTO);
	/**
	* The MediaType instance for Engineering A, 8 1/2 x 11 in.
	*/
	public static final MediaType A = new MediaType(I_A);
	/**
	* The MediaType instance for Engineering B, 11 x 17 in.
	*/
	public static final MediaType B = new MediaType(I_B);
	/**
	* The MediaType instance for Engineering C, 17 x 22 in.
	*/
	public static final MediaType C = new MediaType(I_C);
	/**
	* The MediaType instance for Engineering D, 22 x 34 in.
	*/
	public static final MediaType D = new MediaType(I_D);
	/**
	* The MediaType instance for Engineering E, 34 x 44 in.
	*/
	public static final MediaType E = new MediaType(I_E);
	/**
	* The MediaType instance for North American 10 x 15 in.
	*/
	public static final MediaType NA_10X15_ENVELOPE =
	new MediaType(I_NA_10X15_ENVELOPE);
	/**
	* The MediaType instance for North American 10 x 14 in.
	*/
	public static final MediaType NA_10X14_ENVELOPE =
	new MediaType(I_NA_10X14_ENVELOPE);
	/**
	* The MediaType instance for North American 10 x 13 in.
	*/
	public static final MediaType NA_10X13_ENVELOPE =
	new MediaType(I_NA_10X13_ENVELOPE);
	/**
	* The MediaType instance for North American 9 x 12 in.
	*/
	public static final MediaType NA_9X12_ENVELOPE =
	new MediaType(I_NA_9X12_ENVELOPE);
	/**
	* The MediaType instance for North American 9 x 11 in.
	*/
	public static final MediaType NA_9X11_ENVELOPE =
	new MediaType(I_NA_9X11_ENVELOPE);
	/**
	* The MediaType instance for North American 7 x 9 in.
	*/
	public static final MediaType NA_7X9_ENVELOPE =
	new MediaType(I_NA_7X9_ENVELOPE);
	/**
	* The MediaType instance for North American 6 x 9 in.
	*/
	public static final MediaType NA_6X9_ENVELOPE =
	new MediaType(I_NA_6X9_ENVELOPE);
	/**
	* The MediaType instance for North American #9 Business Envelope,
	* 3 7/8 x 8 7/8 in.
	*/
	public static final MediaType NA_NUMBER_9_ENVELOPE =
	new MediaType(I_NA_NUMBER_9_ENVELOPE);
	/**
	* The MediaType instance for North American #10 Business Envelope,
	* 4 1/8 x 9 1/2 in.
	*/
	public static final MediaType NA_NUMBER_10_ENVELOPE =
	new MediaType(I_NA_NUMBER_10_ENVELOPE);
	/**
	* The MediaType instance for North American #11 Business Envelope,
	* 4 1/2 x 10 3/8 in.
	*/
	public static final MediaType NA_NUMBER_11_ENVELOPE =
	new MediaType(I_NA_NUMBER_11_ENVELOPE);
	/**
	* The MediaType instance for North American #12 Business Envelope,
	* 4 3/4 x 11 in.
	*/
	public static final MediaType NA_NUMBER_12_ENVELOPE =
	new MediaType(I_NA_NUMBER_12_ENVELOPE);
	/**
	* The MediaType instance for North American #14 Business Envelope,
	* 5 x 11 1/2 in.
	*/
	public static final MediaType NA_NUMBER_14_ENVELOPE =
	new MediaType(I_NA_NUMBER_14_ENVELOPE);
	/**
	* The MediaType instance for Invitation Envelope, 220 x 220 mm.
	*/
	public static final MediaType INVITE_ENVELOPE =
	new MediaType(I_INVITE_ENVELOPE);
	/**
	* The MediaType instance for Italy Envelope, 110 x 230 mm.
	*/
	public static final MediaType ITALY_ENVELOPE =
	new MediaType(I_ITALY_ENVELOPE);
	/**
	* The MediaType instance for Monarch Envelope, 3 7/8 x 7 1/2 in.
	*/
	public static final MediaType MONARCH_ENVELOPE =
	new MediaType(I_MONARCH_ENVELOPE);
	/**
	* The MediaType instance for 6 3/4 envelope, 3 5/8 x 6 1/2 in.
	*/
	public static final MediaType PERSONAL_ENVELOPE =
	new MediaType(I_PERSONAL_ENVELOPE);
	/**
	* An alias for ISO_A0.
	*/
	public static final MediaType A0 = ISO_A0;
	/**
	* An alias for ISO_A1.
	*/
	public static final MediaType A1 = ISO_A1;
	/**
	* An alias for ISO_A2.
	*/
	public static final MediaType A2 = ISO_A2;
	/**
	* An alias for ISO_A3.
	*/
	public static final MediaType A3 = ISO_A3;
	/**
	* An alias for ISO_A4.
	*/
	public static final MediaType A4 = ISO_A4;
	/**
	* An alias for ISO_A5.
	*/
	public static final MediaType A5 = ISO_A5;
	/**
	* An alias for ISO_A6.
	*/
	public static final MediaType A6 = ISO_A6;
	/**
	* An alias for ISO_A7.
	*/
	public static final MediaType A7 = ISO_A7;
	/**
	* An alias for ISO_A8.
	*/
	public static final MediaType A8 = ISO_A8;
	/**
	* An alias for ISO_A9.
	*/
	public static final MediaType A9 = ISO_A9;
	/**
	* An alias for ISO_A10.
	*/
	public static final MediaType A10 = ISO_A10;
	/**
	* An alias for ISO_B0.
	*/
	public static final MediaType B0 = ISO_B0;
	/**
	* An alias for ISO_B1.
	*/
	public static final MediaType B1 = ISO_B1;
	/**
	* An alias for ISO_B2.
	*/
	public static final MediaType B2 = ISO_B2;
	/**
	* An alias for ISO_B3.
	*/
	public static final MediaType B3 = ISO_B3;
	/**
	* An alias for ISO_B4.
	*/
	public static final MediaType B4 = ISO_B4;
	/**
	* An alias for ISO_B4.
	*/
	public static final MediaType ISO_B4_ENVELOPE = ISO_B4;
	/**
	* An alias for ISO_B5.
	*/
	public static final MediaType B5 = ISO_B5;
	/**
	* An alias for ISO_B5.
	*/
	public static final MediaType ISO_B5_ENVELOPE = ISO_B5;
	/**
	* An alias for ISO_B6.
	*/
	public static final MediaType B6 = ISO_B6;
	/**
	* An alias for ISO_B7.
	*/
	public static final MediaType B7 = ISO_B7;
	/**
	* An alias for ISO_B8.
	*/
	public static final MediaType B8 = ISO_B8;
	/**
	* An alias for ISO_B9.
	*/
	public static final MediaType B9 = ISO_B9;
	/**
	* An alias for ISO_B10.
	*/
	public static final MediaType B10 = ISO_B10;
	/**
	* An alias for ISO_C0.
	*/
	public static final MediaType C0 = ISO_C0;
	/**
	* An alias for ISO_C0.
	*/
	public static final MediaType ISO_C0_ENVELOPE = ISO_C0;
	/**
	* An alias for ISO_C1.
	*/
	public static final MediaType C1 = ISO_C1;
	/**
	* An alias for ISO_C1.
	*/
	public static final MediaType ISO_C1_ENVELOPE = ISO_C1;
	/**
	* An alias for ISO_C2.
	*/
	public static final MediaType C2 = ISO_C2;
	/**
	* An alias for ISO_C2.
	*/
	public static final MediaType ISO_C2_ENVELOPE = ISO_C2;
	/**
	* An alias for ISO_C3.
	*/
	public static final MediaType C3 = ISO_C3;
	/**
	* An alias for ISO_C3.
	*/
	public static final MediaType ISO_C3_ENVELOPE = ISO_C3;
	/**
	* An alias for ISO_C4.
	*/
	public static final MediaType C4 = ISO_C4;
	/**
	* An alias for ISO_C4.
	*/
	public static final MediaType ISO_C4_ENVELOPE = ISO_C4;
	/**
	* An alias for ISO_C5.
	*/
	public static final MediaType C5 = ISO_C5;
	/**
	* An alias for ISO_C5.
	*/
	public static final MediaType ISO_C5_ENVELOPE = ISO_C5;
	/**
	* An alias for ISO_C6.
	*/
	public static final MediaType C6 = ISO_C6;
	/**
	* An alias for ISO_C6.
	*/
	public static final MediaType ISO_C6_ENVELOPE = ISO_C6;
	/**
	* An alias for ISO_C7.
	*/
	public static final MediaType C7 = ISO_C7;
	/**
	* An alias for ISO_C7.
	*/
	public static final MediaType ISO_C7_ENVELOPE = ISO_C7;
	/**
	* An alias for ISO_C8.
	*/
	public static final MediaType C8 = ISO_C8;
	/**
	* An alias for ISO_C8.
	*/
	public static final MediaType ISO_C8_ENVELOPE = ISO_C8;
	/**
	* An alias for ISO_C9.
	*/
	public static final MediaType C9 = ISO_C9;
	/**
	* An alias for ISO_C9.
	*/
	public static final MediaType ISO_C9_ENVELOPE = ISO_C9;
	/**
	* An alias for ISO_C10.
	*/
	public static final MediaType C10 = ISO_C10;
	/**
	* An alias for ISO_C10.
	*/
	public static final MediaType ISO_C10_ENVELOPE = ISO_C10;
	/**
	* An alias for ISO_DESIGNATED_LONG.
	*/
	public static final MediaType ISO_DESIGNATED_LONG_ENVELOPE =
	ISO_DESIGNATED_LONG;
	/**
	* An alias for INVOICE.
	*/
	public static final MediaType STATEMENT = INVOICE;
	/**
	* An alias for LEDGER.
	*/
	public static final MediaType TABLOID = LEDGER;
	/**
	* An alias for NA_LETTER.
	*/
	public static final MediaType LETTER = NA_LETTER;
	/**
	* An alias for NA_LETTER.
	*/
	public static final MediaType NOTE = NA_LETTER;
	/**
	* An alias for NA_LEGAL.
	*/
	public static final MediaType LEGAL = NA_LEGAL;
	/**
	* An alias for NA_10X15_ENVELOPE.
	*/
	public static final MediaType ENV_10X15 = NA_10X15_ENVELOPE;
	/**
	* An alias for NA_10X14_ENVELOPE.
	*/
	public static final MediaType ENV_10X14 = NA_10X14_ENVELOPE;
	/**
	* An alias for NA_10X13_ENVELOPE.
	*/
	public static final MediaType ENV_10X13 = NA_10X13_ENVELOPE;
	/**
	* An alias for NA_9X12_ENVELOPE.
	*/
	public static final MediaType ENV_9X12 = NA_9X12_ENVELOPE;
	/**
	* An alias for NA_9X11_ENVELOPE.
	*/
	public static final MediaType ENV_9X11 = NA_9X11_ENVELOPE;
	/**
	* An alias for NA_7X9_ENVELOPE.
	*/
	public static final MediaType ENV_7X9 = NA_7X9_ENVELOPE;
	/**
	* An alias for NA_6X9_ENVELOPE.
	*/
	public static final MediaType ENV_6X9 = NA_6X9_ENVELOPE;
	/**
	* An alias for NA_NUMBER_9_ENVELOPE.
	*/
	public static final MediaType ENV_9 = NA_NUMBER_9_ENVELOPE;
	/**
	* An alias for NA_NUMBER_10_ENVELOPE.
	*/
	public static final MediaType ENV_10 = NA_NUMBER_10_ENVELOPE;
	/**
	* An alias for NA_NUMBER_11_ENVELOPE.
	*/
	public static final MediaType ENV_11 = NA_NUMBER_11_ENVELOPE;
	/**
	* An alias for NA_NUMBER_12_ENVELOPE.
	*/
	public static final MediaType ENV_12 = NA_NUMBER_12_ENVELOPE;
	/**
	* An alias for NA_NUMBER_14_ENVELOPE.
	*/
	public static final MediaType ENV_14 = NA_NUMBER_14_ENVELOPE;
	/**
	* An alias for INVITE_ENVELOPE.
	*/
	public static final MediaType ENV_INVITE = INVITE_ENVELOPE;
	/**
	* An alias for ITALY_ENVELOPE.
	*/
	public static final MediaType ENV_ITALY = ITALY_ENVELOPE;
	/**
	* An alias for MONARCH_ENVELOPE.
	*/
	public static final MediaType ENV_MONARCH = MONARCH_ENVELOPE;
	/**
	* An alias for PERSONAL_ENVELOPE.
	*/
	public static final MediaType ENV_PERSONAL = PERSONAL_ENVELOPE;
	/**
	* An alias for INVITE_ENVELOPE.
	*/
	public static final MediaType INVITE = INVITE_ENVELOPE;
	/**
	* An alias for ITALY_ENVELOPE.
	*/
	public static final MediaType ITALY = ITALY_ENVELOPE;
	/**
	* An alias for MONARCH_ENVELOPE.
	*/
	public static final MediaType MONARCH = MONARCH_ENVELOPE;
	/**
	* An alias for PERSONAL_ENVELOPE.
	*/
	public static final MediaType PERSONAL = PERSONAL_ENVELOPE;

	private MediaType(int type) {
	super(type, NAMES);
	}
	}

	/**
	* A type-safe enumeration of possible orientations. These orientations
	* are in partial compliance with IPP 1.1.
	* @since 1.3
	*/
	public static final class OrientationRequestedType extends AttributeValue {
	private static final int I_PORTRAIT = 0;
	private static final int I_LANDSCAPE = 1;

	private static final String NAMES[] = {
	"portrait", "landscape"
	};

	/**
	* The OrientationRequestedType instance to use for specifying a
	* portrait orientation.
	*/
	public static final OrientationRequestedType PORTRAIT =
	new OrientationRequestedType(I_PORTRAIT);
	/**
	* The OrientationRequestedType instance to use for specifying a
	* landscape orientation.
	*/
	public static final OrientationRequestedType LANDSCAPE =
	new OrientationRequestedType(I_LANDSCAPE);

	private OrientationRequestedType(int type) {
	super(type, NAMES);
	}
	}

	/**
	* A type-safe enumeration of possible origins.
	* @since 1.3
	*/
	public static final class OriginType extends AttributeValue {
	private static final int I_PHYSICAL = 0;
	private static final int I_PRINTABLE = 1;

	private static final String NAMES[] = {
	"physical", "printable"
	};

	/**
	* The OriginType instance to use for specifying a physical origin.
	*/
	public static final OriginType PHYSICAL = new OriginType(I_PHYSICAL);
	/**
	* The OriginType instance to use for specifying a printable origin.
	*/
	public static final OriginType PRINTABLE = new OriginType(I_PRINTABLE);

	private OriginType(int type) {
	super(type, NAMES);
	}
	}

	/**
	* A type-safe enumeration of possible print qualities. These print
	* qualities are in compliance with IPP 1.1.
	* @since 1.3
	*/
	public static final class PrintQualityType extends AttributeValue {
	private static final int I_HIGH = 0;
	private static final int I_NORMAL = 1;
	private static final int I_DRAFT = 2;

	private static final String NAMES[] = {
	"high", "normal", "draft"
	};

	/**
	* The PrintQualityType instance to use for specifying a high print
	* quality.
	*/
	public static final PrintQualityType HIGH =
	new PrintQualityType(I_HIGH);
	/**
	* The PrintQualityType instance to use for specifying a normal print
	* quality.
	*/
	public static final PrintQualityType NORMAL =
	new PrintQualityType(I_NORMAL);
	/**
	* The PrintQualityType instance to use for specifying a draft print
	* quality.
	*/
	public static final PrintQualityType DRAFT =
	new PrintQualityType(I_DRAFT);

	private PrintQualityType(int type) {
	super(type, NAMES);
	}
	}

	private ColorType color;
	private MediaType media;
	private OrientationRequestedType orientationRequested;
	private OriginType origin;
	private PrintQualityType printQuality;
	private int[] printerResolution;

	/**
	* Constructs a PageAttributes instance with default values for every
	* attribute.
	*/
	public PageAttributes() {
	setColor(ColorType.MONOCHROME);
	setMediaToDefault();
	setOrientationRequestedToDefault();
	setOrigin(OriginType.PHYSICAL);
	setPrintQualityToDefault();
	setPrinterResolutionToDefault();
	}

	/**
	* Constructs a PageAttributes instance which is a copy of the supplied
	* PageAttributes.
	*
	* @param obj the PageAttributes to copy.
	*/
	public PageAttributes(PageAttributes obj) {
	set(obj);
	}

	/**
	* Constructs a PageAttributes instance with the specified values for
	* every attribute.
	*
	* @param color ColorType.COLOR or ColorType.MONOCHROME.
	* @param media one of the constant fields of the MediaType class.
	* @param orientationRequested OrientationRequestedType.PORTRAIT or
	* OrientationRequestedType.LANDSCAPE.
	* @param origin OriginType.PHYSICAL or OriginType.PRINTABLE
	* @param printQuality PrintQualityType.DRAFT, PrintQualityType.NORMAL,
	* or PrintQualityType.HIGH
	* @param printerResolution an integer array of 3 elements. The first
	* element must be greater than 0. The second element must be
	* must be greater than 0. The third element must be either
	* <code>3</code> or <code>4</code>.
	* @throws IllegalArgumentException if one or more of the above
	* conditions is violated.
	*/
	public PageAttributes(ColorType color, MediaType media,
	OrientationRequestedType orientationRequested,
	OriginType origin, PrintQualityType printQuality,
	int[] printerResolution) {
	setColor(color);
	setMedia(media);
	setOrientationRequested(orientationRequested);
	setOrigin(origin);
	setPrintQuality(printQuality);
	setPrinterResolution(printerResolution);
	}

	/**
	* Creates and returns a copy of this PageAttributes.
	*
	* @return the newly created copy. It is safe to cast this Object into
	* a PageAttributes.
	*/
	public Object clone() {
	try {
	return super.clone();
	} catch (CloneNotSupportedException e) {
	// Since we implement Cloneable, this should never happen
	throw new InternalError(e);
	}
	}

	/**
	* Sets all of the attributes of this PageAttributes to the same values as
	* the attributes of obj.
	*
	* @param obj the PageAttributes to copy.
	*/
	public void set(PageAttributes obj) {
	color = obj.color;
	media = obj.media;
	orientationRequested = obj.orientationRequested;
	origin = obj.origin;
	printQuality = obj.printQuality;
	// okay because we never modify the contents of printerResolution
	printerResolution = obj.printerResolution;
	}

	/**
	* Returns whether pages using these attributes will be rendered in
	* color or monochrome. This attribute is updated to the value chosen
	* by the user.
	*
	* @return ColorType.COLOR or ColorType.MONOCHROME.
	*/
	public ColorType getColor() {
	return color;
	}

	/**
	* Specifies whether pages using these attributes will be rendered in
	* color or monochrome. Not specifying this attribute is equivalent to
	* specifying ColorType.MONOCHROME.
	*
	* @param color ColorType.COLOR or ColorType.MONOCHROME.
	* @throws IllegalArgumentException if color is null.
	*/
	public void setColor(ColorType color) {
	if (color == null) {
	throw new IllegalArgumentException("Invalid value for attribute "+
	"color");
	}
	this.color = color;
	}

	/**
	* Returns the paper size for pages using these attributes. This
	* attribute is updated to the value chosen by the user.
	*
	* @return one of the constant fields of the MediaType class.
	*/
	public MediaType getMedia() {
	return media;
	}

	/**
	* Specifies the desired paper size for pages using these attributes. The
	* actual paper size will be determined by the limitations of the target
	* printer. If an exact match cannot be found, an implementation will
	* choose the closest possible match. Not specifying this attribute is
	* equivalent to specifying the default size for the default locale. The
	* default size for locales in the United States and Canada is
	* MediaType.NA_LETTER. The default size for all other locales is
	* MediaType.ISO_A4.
	*
	* @param media one of the constant fields of the MediaType class.
	* @throws IllegalArgumentException if media is null.
	*/
	public void setMedia(MediaType media) {
	if (media == null) {
	throw new IllegalArgumentException("Invalid value for attribute "+
	"media");
	}
	this.media = media;
	}

	/**
	* Sets the paper size for pages using these attributes to the default
	* size for the default locale. The default size for locales in the
	* United States and Canada is MediaType.NA_LETTER. The default size for
	* all other locales is MediaType.ISO_A4.
	*/
	public void setMediaToDefault(){
	String defaultCountry = Locale.getDefault().getCountry();
	if (defaultCountry != null &&
	(defaultCountry.equals(Locale.US.getCountry()) \|\|
	defaultCountry.equals(Locale.CANADA.getCountry()))) {
	setMedia(MediaType.NA_LETTER);
	} else {
	setMedia(MediaType.ISO_A4);
	}
	}

	/**
	* Returns the print orientation for pages using these attributes. This
	* attribute is updated to the value chosen by the user.
	*
	* @return OrientationRequestedType.PORTRAIT or
	* OrientationRequestedType.LANDSCAPE.
	*/
	public OrientationRequestedType getOrientationRequested() {
	return orientationRequested;
	}

	/**
	* Specifies the print orientation for pages using these attributes. Not
	* specifying the property is equivalent to specifying
	* OrientationRequestedType.PORTRAIT.
	*
	* @param orientationRequested OrientationRequestedType.PORTRAIT or
	* OrientationRequestedType.LANDSCAPE.
	* @throws IllegalArgumentException if orientationRequested is null.
	*/
	public void setOrientationRequested(OrientationRequestedType
	orientationRequested) {
	if (orientationRequested == null) {
	throw new IllegalArgumentException("Invalid value for attribute "+
	"orientationRequested");
	}
	this.orientationRequested = orientationRequested;
	}

	/**
	* Specifies the print orientation for pages using these attributes.
	* Specifying <code>3</code> denotes portrait. Specifying <code>4</code>
	* denotes landscape. Specifying any other value will generate an
	* IllegalArgumentException. Not specifying the property is equivalent
	* to calling setOrientationRequested(OrientationRequestedType.PORTRAIT).
	*
	* @param orientationRequested <code>3</code> or <code>4</code>
	* @throws IllegalArgumentException if orientationRequested is not
	* <code>3</code> or <code>4</code>
	*/
	public void setOrientationRequested(int orientationRequested) {
	switch (orientationRequested) {
	case 3:
	setOrientationRequested(OrientationRequestedType.PORTRAIT);
	break;
	case 4:
	setOrientationRequested(OrientationRequestedType.LANDSCAPE);
	break;
	default:
	// This will throw an IllegalArgumentException
	setOrientationRequested(null);
	break;
	}
	}

	/**
	* Sets the print orientation for pages using these attributes to the
	* default. The default orientation is portrait.
	*/
	public void setOrientationRequestedToDefault() {
	setOrientationRequested(OrientationRequestedType.PORTRAIT);
	}

	/**
	* Returns whether drawing at (0, 0) to pages using these attributes
	* draws at the upper-left corner of the physical page, or at the
	* upper-left corner of the printable area. (Note that these locations
	* could be equivalent.) This attribute cannot be modified by,
	* and is not subject to any limitations of, the implementation or the
	* target printer.
	*
	* @return OriginType.PHYSICAL or OriginType.PRINTABLE
	*/
	public OriginType getOrigin() {
	return origin;
	}

	/**
	* Specifies whether drawing at (0, 0) to pages using these attributes
	* draws at the upper-left corner of the physical page, or at the
	* upper-left corner of the printable area. (Note that these locations
	* could be equivalent.) Not specifying the property is equivalent to
	* specifying OriginType.PHYSICAL.
	*
	* @param origin OriginType.PHYSICAL or OriginType.PRINTABLE
	* @throws IllegalArgumentException if origin is null.
	*/
	public void setOrigin(OriginType origin) {
	if (origin == null) {
	throw new IllegalArgumentException("Invalid value for attribute "+
	"origin");
	}
	this.origin = origin;
	}

	/**
	* Returns the print quality for pages using these attributes. This
	* attribute is updated to the value chosen by the user.
	*
	* @return PrintQualityType.DRAFT, PrintQualityType.NORMAL, or
	* PrintQualityType.HIGH
	*/
	public PrintQualityType getPrintQuality() {
	return printQuality;
	}

	/**
	* Specifies the print quality for pages using these attributes. Not
	* specifying the property is equivalent to specifying
	* PrintQualityType.NORMAL.
	*
	* @param printQuality PrintQualityType.DRAFT, PrintQualityType.NORMAL,
	* or PrintQualityType.HIGH
	* @throws IllegalArgumentException if printQuality is null.
	*/
	public void setPrintQuality(PrintQualityType printQuality) {
	if (printQuality == null) {
	throw new IllegalArgumentException("Invalid value for attribute "+
	"printQuality");
	}
	this.printQuality = printQuality;
	}

	/**
	* Specifies the print quality for pages using these attributes.
	* Specifying <code>3</code> denotes draft. Specifying <code>4</code>
	* denotes normal. Specifying <code>5</code> denotes high. Specifying
	* any other value will generate an IllegalArgumentException. Not
	* specifying the property is equivalent to calling
	* setPrintQuality(PrintQualityType.NORMAL).
	*
	* @param printQuality <code>3</code>, <code>4</code>, or <code>5</code>
	* @throws IllegalArgumentException if printQuality is not <code>3
	* </code>, <code>4</code>, or <code>5</code>
	*/
	public void setPrintQuality(int printQuality) {
	switch (printQuality) {
	case 3:
	setPrintQuality(PrintQualityType.DRAFT);
	break;
	case 4:
	setPrintQuality(PrintQualityType.NORMAL);
	break;
	case 5:
	setPrintQuality(PrintQualityType.HIGH);
	break;
	default:
	// This will throw an IllegalArgumentException
	setPrintQuality(null);
	break;
	}
	}

	/**
	* Sets the print quality for pages using these attributes to the default.
	* The default print quality is normal.
	*/
	public void setPrintQualityToDefault() {
	setPrintQuality(PrintQualityType.NORMAL);
	}

	/**
	* Returns the print resolution for pages using these attributes.
	* Index 0 of the array specifies the cross feed direction resolution
	* (typically the horizontal resolution). Index 1 of the array specifies
	* the feed direction resolution (typically the vertical resolution).
	* Index 2 of the array specifies whether the resolutions are in dots per
	* inch or dots per centimeter. <code>3</code> denotes dots per inch.
	* <code>4</code> denotes dots per centimeter.
	*
	* @return an integer array of 3 elements. The first
	* element must be greater than 0. The second element must be
	* must be greater than 0. The third element must be either
	* <code>3</code> or <code>4</code>.
	*/
	public int[] getPrinterResolution() {
	// Return a copy because otherwise client code could circumvent the
	// the checks made in setPrinterResolution by modifying the
	// returned array.
	int[] copy = new int[3];
	copy[0] = printerResolution[0];
	copy[1] = printerResolution[1];
	copy[2] = printerResolution[2];
	return copy;
	}

	/**
	* Specifies the desired print resolution for pages using these attributes.
	* The actual resolution will be determined by the limitations of the
	* implementation and the target printer. Index 0 of the array specifies
	* the cross feed direction resolution (typically the horizontal
	* resolution). Index 1 of the array specifies the feed direction
	* resolution (typically the vertical resolution). Index 2 of the array
	* specifies whether the resolutions are in dots per inch or dots per
	* centimeter. <code>3</code> denotes dots per inch. <code>4</code>
	* denotes dots per centimeter. Note that the 1.1 printing implementation
	* (Toolkit.getPrintJob) requires that the feed and cross feed resolutions
	* be the same. Not specifying the property is equivalent to calling
	* setPrinterResolution(72).
	*
	* @param printerResolution an integer array of 3 elements. The first
	* element must be greater than 0. The second element must be
	* must be greater than 0. The third element must be either
	* <code>3</code> or <code>4</code>.
	* @throws IllegalArgumentException if one or more of the above
	* conditions is violated.
	*/
	public void setPrinterResolution(int[] printerResolution) {
	if (printerResolution == null \|\|
	printerResolution.length != 3 \|\|
	printerResolution[0] <= 0 \|\|
	printerResolution[1] <= 0 \|\|
	(printerResolution[2] != 3 && printerResolution[2] != 4)) {
	throw new IllegalArgumentException("Invalid value for attribute "+
	"printerResolution");
	}
	// Store a copy because otherwise client code could circumvent the
	// the checks made above by holding a reference to the array and
	// modifying it after calling setPrinterResolution.
	int[] copy = new int[3];
	copy[0] = printerResolution[0];
	copy[1] = printerResolution[1];
	copy[2] = printerResolution[2];
	this.printerResolution = copy;
	}

	/**
	* Specifies the desired cross feed and feed print resolutions in dots per
	* inch for pages using these attributes. The same value is used for both
	* resolutions. The actual resolutions will be determined by the
	* limitations of the implementation and the target printer. Not
	* specifying the property is equivalent to specifying <code>72</code>.
	*
	* @param printerResolution an integer greater than 0.
	* @throws IllegalArgumentException if printerResolution is less than or
	* equal to 0.
	*/
	public void setPrinterResolution(int printerResolution) {
	setPrinterResolution(new int[] { printerResolution, printerResolution,
	3 } );
	}

	/**
	* Sets the printer resolution for pages using these attributes to the
	* default. The default is 72 dpi for both the feed and cross feed
	* resolutions.
	*/
	public void setPrinterResolutionToDefault() {
	setPrinterResolution(72);
	}

	/**
	* Determines whether two PageAttributes are equal to each other.
	* <p>
	* Two PageAttributes are equal if and only if each of their attributes are
	* equal. Attributes of enumeration type are equal if and only if the
	* fields refer to the same unique enumeration object. This means that
	* an aliased media is equal to its underlying unique media. Printer
	* resolutions are equal if and only if the feed resolution, cross feed
	* resolution, and units are equal.
	*
	* @param obj the object whose equality will be checked.
	* @return whether obj is equal to this PageAttribute according to the
	* above criteria.
	*/
	public boolean equals(Object obj) {
	if (!(obj instanceof PageAttributes)) {
	return false;
	}

	PageAttributes rhs = (PageAttributes)obj;

	return (color == rhs.color &&
	media == rhs.media &&
	orientationRequested == rhs.orientationRequested &&
	origin == rhs.origin &&
	printQuality == rhs.printQuality &&
	printerResolution[0] == rhs.printerResolution[0] &&
	printerResolution[1] == rhs.printerResolution[1] &&
	printerResolution[2] == rhs.printerResolution[2]);
	}

	/**
	* Returns a hash code value for this PageAttributes.
	*
	* @return the hash code.
	*/
	public int hashCode() {
	return (color.hashCode() << 31 ^
	media.hashCode() << 24 ^
	orientationRequested.hashCode() << 23 ^
	origin.hashCode() << 22 ^
	printQuality.hashCode() << 20 ^
	printerResolution[2] >> 2 << 19 ^
	printerResolution[1] << 10 ^
	printerResolution[0]);
	}

	/**
	* Returns a string representation of this PageAttributes.
	*
	* @return the string representation.
	*/
	public String toString() {
	// int[] printerResolution = getPrinterResolution();
	return "color=" + getColor() + ",media=" + getMedia() +
	",orientation-requested=" + getOrientationRequested() +
	",origin=" + getOrigin() + ",print-quality=" + getPrintQuality() +
	",printer-resolution=[" + printerResolution[0] + "," +
	printerResolution[1] + "," + printerResolution[2] + "]";
	}
	}

Back to index...