You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1379 lines
50 KiB
1379 lines
50 KiB
/*
|
|
* Copyright (c) 1999, 2013, Oracle and/or its affiliates. All rights reserved.
|
|
* ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*/
|
|
|
|
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] + "]";
|
|
}
|
|
}
|