src/share/classes/javax/print/attribute/standard/JobStateReasons.java

Print this page


   1 /*
   2  * Copyright (c) 2000, 2006, 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


 132      * {@link JobStateReason JobStateReason}. If this job state reasons
 133      * attribute already contains the specified element, the call leaves this
 134      * job state reasons attribute unchanged and returns <tt>false</tt>.
 135      *
 136      * @param  o  Element to be added to this job state reasons attribute.
 137      *
 138      * @return  <tt>true</tt> if this job state reasons attribute did not
 139      *          already contain the specified element.
 140      *
 141      * @throws  NullPointerException
 142      *     (unchecked exception) Thrown if the specified element is null.
 143      * @throws  ClassCastException
 144      *     (unchecked exception) Thrown if the specified element is not an
 145      *     instance of class {@link JobStateReason JobStateReason}.
 146      * @since 1.5
 147      */
 148     public boolean add(JobStateReason o) {
 149         if (o == null) {
 150             throw new NullPointerException();
 151         }
 152         return super.add ((JobStateReason) o);
 153     }
 154 
 155     /**
 156      * Get the printing attribute class which is to be used as the "category"
 157      * for this printing attribute value.
 158      * <P>
 159      * For class JobStateReasons, the category is class JobStateReasons itself.
 160      *
 161      * @return  Printing attribute class (category), an instance of class
 162      *          {@link java.lang.Class java.lang.Class}.
 163      */
 164     public final Class<? extends Attribute> getCategory() {
 165         return JobStateReasons.class;
 166     }
 167 
 168     /**
 169      * Get the name of the category of which this attribute value is an
 170      * instance.
 171      * <P>
 172      * For class JobStateReasons, the category
   1 /*
   2  * Copyright (c) 2000, 2014, 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


 132      * {@link JobStateReason JobStateReason}. If this job state reasons
 133      * attribute already contains the specified element, the call leaves this
 134      * job state reasons attribute unchanged and returns <tt>false</tt>.
 135      *
 136      * @param  o  Element to be added to this job state reasons attribute.
 137      *
 138      * @return  <tt>true</tt> if this job state reasons attribute did not
 139      *          already contain the specified element.
 140      *
 141      * @throws  NullPointerException
 142      *     (unchecked exception) Thrown if the specified element is null.
 143      * @throws  ClassCastException
 144      *     (unchecked exception) Thrown if the specified element is not an
 145      *     instance of class {@link JobStateReason JobStateReason}.
 146      * @since 1.5
 147      */
 148     public boolean add(JobStateReason o) {
 149         if (o == null) {
 150             throw new NullPointerException();
 151         }
 152         return super.add(o);
 153     }
 154 
 155     /**
 156      * Get the printing attribute class which is to be used as the "category"
 157      * for this printing attribute value.
 158      * <P>
 159      * For class JobStateReasons, the category is class JobStateReasons itself.
 160      *
 161      * @return  Printing attribute class (category), an instance of class
 162      *          {@link java.lang.Class java.lang.Class}.
 163      */
 164     public final Class<? extends Attribute> getCategory() {
 165         return JobStateReasons.class;
 166     }
 167 
 168     /**
 169      * Get the name of the category of which this attribute value is an
 170      * instance.
 171      * <P>
 172      * For class JobStateReasons, the category