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

Print this page




  34  * Class PrinterMessageFromOperator is a printing attribute class, a text
  35  * attribute, that provides a message from an operator, system administrator,
  36  * or "intelligent" process to indicate to the end user information about or
  37  * status of the printer, such as why it is unavailable or when it is
  38  * expected to be available.
  39  * <P>
  40  * A Print Service's attribute set includes zero instances or one instance of
  41  * a
  42  * PrinterMessageFromOperator attribute, not more than one instance. A new
  43  * PrinterMessageFromOperator attribute replaces an existing
  44  * PrinterMessageFromOperator attribute, if any. In other words,
  45  * PrinterMessageFromOperator is not intended to be a history log.
  46  * If it wishes, the client can detect changes to a Print Service's
  47  * PrinterMessageFromOperator
  48  * attribute and maintain the client's own history log of the
  49  * PrinterMessageFromOperator attribute values.
  50  * <P>
  51  * <B>IPP Compatibility:</B> The string value gives the IPP name value. The
  52  * locale gives the IPP natural language. The category name returned by
  53  * <CODE>getName()</CODE> gives the IPP attribute name.
  54  * <P>
  55  *
  56  * @author  Alan Kaminsky
  57  */
  58 public final class PrinterMessageFromOperator   extends TextSyntax
  59     implements PrintServiceAttribute {
  60 
  61     static final long serialVersionUID = -4486871203218629318L;
  62 
  63     /**
  64      * Constructs a new printer message from operator attribute with the
  65      * given message and locale.
  66      *
  67      * @param  message  Message.
  68      * @param  locale   Natural language of the text string. null
  69      * is interpreted to mean the default locale as returned
  70      * by <code>Locale.getDefault()</code>
  71      *
  72      * @exception  NullPointerException
  73      *     (unchecked exception) Thrown if <CODE>message</CODE> is null.
  74      */




  34  * Class PrinterMessageFromOperator is a printing attribute class, a text
  35  * attribute, that provides a message from an operator, system administrator,
  36  * or "intelligent" process to indicate to the end user information about or
  37  * status of the printer, such as why it is unavailable or when it is
  38  * expected to be available.
  39  * <P>
  40  * A Print Service's attribute set includes zero instances or one instance of
  41  * a
  42  * PrinterMessageFromOperator attribute, not more than one instance. A new
  43  * PrinterMessageFromOperator attribute replaces an existing
  44  * PrinterMessageFromOperator attribute, if any. In other words,
  45  * PrinterMessageFromOperator is not intended to be a history log.
  46  * If it wishes, the client can detect changes to a Print Service's
  47  * PrinterMessageFromOperator
  48  * attribute and maintain the client's own history log of the
  49  * PrinterMessageFromOperator attribute values.
  50  * <P>
  51  * <B>IPP Compatibility:</B> The string value gives the IPP name value. The
  52  * locale gives the IPP natural language. The category name returned by
  53  * <CODE>getName()</CODE> gives the IPP attribute name.

  54  *
  55  * @author  Alan Kaminsky
  56  */
  57 public final class PrinterMessageFromOperator   extends TextSyntax
  58     implements PrintServiceAttribute {
  59 
  60     static final long serialVersionUID = -4486871203218629318L;
  61 
  62     /**
  63      * Constructs a new printer message from operator attribute with the
  64      * given message and locale.
  65      *
  66      * @param  message  Message.
  67      * @param  locale   Natural language of the text string. null
  68      * is interpreted to mean the default locale as returned
  69      * by <code>Locale.getDefault()</code>
  70      *
  71      * @exception  NullPointerException
  72      *     (unchecked exception) Thrown if <CODE>message</CODE> is null.
  73      */