1 /*
2 * Copyright 2000 Sun Microsystems, Inc. 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. Sun designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Sun 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 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
22 * CA 95054 USA or visit www.sun.com if you need additional information or
23 * have any questions.
24 */
25
26 package javax.print;
27
28 import javax.print.attribute.Attribute;
29
30 /**
31 * Interface AttributeException is a mixin interface which a subclass of
32 * {@link
33 * PrintException PrintException} can implement to report an error condition
34 * involving one or more printing attributes that a particular Print
35 * Service instance does not support. Either the attribute is not supported at
36 * all, or the attribute is supported but the particular specified value is not
37 * supported. The Print Service API does not define any print exception
38 * classes that implement interface AttributeException, that being left to the
39 * Print Service implementor's discretion.
40 *
41 */
42
43 public interface AttributeException {
44
45
46 /**
47 * Returns the array of printing attribute classes for which the Print
48 * Service instance does not support the attribute at all, or null if
49 * there are no such attributes. The objects in the returned array are
50 * classes that extend the base interface
51 * {@link javax.print.attribute.Attribute Attribute}.
52 *
53 * @return unsupported attribute classes
54 */
55 public Class[] getUnsupportedAttributes();
56
57 /**
58 * Returns the array of printing attributes for which the Print Service
59 * instance supports the attribute but does not support that particular
60 * value of the attribute, or null if there are no such attribute values.
61 *
62 * @return unsupported attribute values
63 */
64 public Attribute[] getUnsupportedValues();
65
66 }
Save This Page