1 /*
2 * Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation. Oracle designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Oracle in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 * or visit www.oracle.com if you need additional information or have any
23 * questions.
24 */
25 package javax.print.attribute.standard;
26
27 import javax.print.attribute.Attribute;
28 import javax.print.attribute.DocAttribute;
29 import javax.print.attribute.PrintJobAttribute;
30 import javax.print.attribute.PrintRequestAttribute;
31
32 /**
33 * Class MediaPrintableArea is a printing attribute used to distinguish
34 * the printable and non-printable areas of media.
35 * <p>
36 * The printable area is specified to be a rectangle, within the overall
37 * dimensions of a media.
38 * <p>
39 * Most printers cannot print on the entire surface of the media, due
40 * to printer hardware limitations. This class can be used to query
41 * the acceptable values for a supposed print job, and to request an area
42 * within the constraints of the printable area to be used in a print job.
43 * <p>
44 * To query for the printable area, a client must supply a suitable context.
45 * Without specifying at the very least the size of the media being used
46 * no meaningful value for printable area can be obtained.
47 * <p>
|
1 /*
2 * Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation. Oracle designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Oracle in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 * or visit www.oracle.com if you need additional information or have any
23 * questions.
24 */
25 package javax.print.attribute.standard;
26
27 import javax.print.DocFlavor;
28 import javax.print.attribute.Attribute;
29 import javax.print.attribute.AttributeSet;
30 import javax.print.attribute.DocAttribute;
31 import javax.print.attribute.PrintJobAttribute;
32 import javax.print.attribute.PrintRequestAttribute;
33
34 /**
35 * Class MediaPrintableArea is a printing attribute used to distinguish
36 * the printable and non-printable areas of media.
37 * <p>
38 * The printable area is specified to be a rectangle, within the overall
39 * dimensions of a media.
40 * <p>
41 * Most printers cannot print on the entire surface of the media, due
42 * to printer hardware limitations. This class can be used to query
43 * the acceptable values for a supposed print job, and to request an area
44 * within the constraints of the printable area to be used in a print job.
45 * <p>
46 * To query for the printable area, a client must supply a suitable context.
47 * Without specifying at the very least the size of the media being used
48 * no meaningful value for printable area can be obtained.
49 * <p>
|