< prev index next >

src/java.desktop/share/classes/javax/print/attribute/package-info.java

Print this page




  63  * <h4>Attribute Categories and Values</h4>
  64  * Each printer has a set of capabilities, such as the ability to print on
  65  * different paper sizes or the ability to print more than one copy. Each of the
  66  * capabilities has a range of values. For example, a printer's orientation
  67  * capability might have this range of values: [landscape, portrait]. For each
  68  * print request, the capability is set to one of these values. The Java Print
  69  * Service API uses the term <b>attribute category</b> to refer to a printer
  70  * capability and the term <b>attribute value</b> to refer to the value of the
  71  * capability.
  72  * <p>
  73  * In the Java Print Service API, an attribute category is represented by a Java
  74  * class implementing the <a href="Attribute.html">Attribute</a> interface.
  75  * Attribute values are instances of such a class or one of its subclasses. For
  76  * example, to specify the number of copies, an application constructs an
  77  * instance of the <a href="standard/Copies.html">Copies</a> class with the
  78  * number of desired copies and uses the {@code Copies} instance as part of the
  79  * print request. In this case, the {@code Copies} class represents the
  80  * attribute category, and the {@code Copies} instance represents the attribute
  81  * value.
  82  *
  83  * <h4><a name="role"></a>Attribute Roles</h4>
  84  * When submitting a print job to a printer, the client provides the attributes
  85  * describing the characteristics of the print data, such as the document name,
  86  * and how the print data should be printed, such as double-sided, five copies.
  87  * If a print job consists of multiple pieces of print data, different pieces
  88  * might have different processing instructions, such as 8 x 11 inch media for
  89  * the first document, and 11 x 17 inch media for another document.
  90  * <p>
  91  * Once the printer starts processing the print job, additional information
  92  * about the job becomes available, which might include: the job state (such as
  93  * <i>completed</i> or <i>queued</i>) and the number of pages printed so far.
  94  * These pieces of information are also attributes. Attributes can also describe
  95  * the printer itself, such as: the printer name, the printer location, and the
  96  * number of jobs queued.
  97  * <p>
  98  * The Java Print Service API defines these different kinds of attributes with
  99  * five subinterfaces of {@code Attribute}:
 100  * <ul>
 101  *   <li><a href="DocAttribute.html">DocAttribute</a> specifies a characteristic
 102  *   of an individual document and the print job settings to be applied to an
 103  *   individual document.




  63  * <h4>Attribute Categories and Values</h4>
  64  * Each printer has a set of capabilities, such as the ability to print on
  65  * different paper sizes or the ability to print more than one copy. Each of the
  66  * capabilities has a range of values. For example, a printer's orientation
  67  * capability might have this range of values: [landscape, portrait]. For each
  68  * print request, the capability is set to one of these values. The Java Print
  69  * Service API uses the term <b>attribute category</b> to refer to a printer
  70  * capability and the term <b>attribute value</b> to refer to the value of the
  71  * capability.
  72  * <p>
  73  * In the Java Print Service API, an attribute category is represented by a Java
  74  * class implementing the <a href="Attribute.html">Attribute</a> interface.
  75  * Attribute values are instances of such a class or one of its subclasses. For
  76  * example, to specify the number of copies, an application constructs an
  77  * instance of the <a href="standard/Copies.html">Copies</a> class with the
  78  * number of desired copies and uses the {@code Copies} instance as part of the
  79  * print request. In this case, the {@code Copies} class represents the
  80  * attribute category, and the {@code Copies} instance represents the attribute
  81  * value.
  82  *
  83  * <h4><a id="role"></a>Attribute Roles</h4>
  84  * When submitting a print job to a printer, the client provides the attributes
  85  * describing the characteristics of the print data, such as the document name,
  86  * and how the print data should be printed, such as double-sided, five copies.
  87  * If a print job consists of multiple pieces of print data, different pieces
  88  * might have different processing instructions, such as 8 x 11 inch media for
  89  * the first document, and 11 x 17 inch media for another document.
  90  * <p>
  91  * Once the printer starts processing the print job, additional information
  92  * about the job becomes available, which might include: the job state (such as
  93  * <i>completed</i> or <i>queued</i>) and the number of pages printed so far.
  94  * These pieces of information are also attributes. Attributes can also describe
  95  * the printer itself, such as: the printer name, the printer location, and the
  96  * number of jobs queued.
  97  * <p>
  98  * The Java Print Service API defines these different kinds of attributes with
  99  * five subinterfaces of {@code Attribute}:
 100  * <ul>
 101  *   <li><a href="DocAttribute.html">DocAttribute</a> specifies a characteristic
 102  *   of an individual document and the print job settings to be applied to an
 103  *   individual document.


< prev index next >