< prev index next >
src/java.desktop/share/classes/javax/print/attribute/standard/OrientationRequested.java
Print this page
*** 34,64 ****
* Class OrientationRequested is a printing attribute class, an enumeration,
* that indicates the desired orientation for printed print-stream pages; it
* does not describe the orientation of the client-supplied print-stream
* pages.
* <P>
! * For some document formats (such as <CODE>"application/postscript"</CODE>),
* the desired orientation of the print-stream pages is specified within the
* document data. This information is generated by a device driver prior to
* the submission of the print job. Other document formats (such as
! * <CODE>"text/plain"</CODE>) do not include the notion of desired orientation
* within the document data. In the latter case it is possible for the printer
* to bind the desired orientation to the document data after it has been
* submitted. It is expected that a printer would only support the
* OrientationRequested attribute for some document formats (e.g.,
! * <CODE>"text/plain"</CODE> or <CODE>"text/html"</CODE>) but not others (e.g.
! * <CODE>"application/postscript"</CODE>). This is no different from any other
* job template attribute, since a print job can always impose constraints
* among the values of different job template attributes.
* However, a special mention
* is made here since it is very likely that a printer will support the
* OrientationRequested attribute for only a subset of the supported document
* formats.
* <P>
* <B>IPP Compatibility:</B> The category name returned by
! * <CODE>getName()</CODE> is the IPP attribute name. The enumeration's
! * integer value is the IPP enum value. The <code>toString()</code> method
* returns the IPP string representation of the attribute value.
*
* @author Alan Kaminsky
*/
public final class OrientationRequested extends EnumSyntax
--- 34,64 ----
* Class OrientationRequested is a printing attribute class, an enumeration,
* that indicates the desired orientation for printed print-stream pages; it
* does not describe the orientation of the client-supplied print-stream
* pages.
* <P>
! * For some document formats (such as {@code "application/postscript"}),
* the desired orientation of the print-stream pages is specified within the
* document data. This information is generated by a device driver prior to
* the submission of the print job. Other document formats (such as
! * {@code "text/plain"}) do not include the notion of desired orientation
* within the document data. In the latter case it is possible for the printer
* to bind the desired orientation to the document data after it has been
* submitted. It is expected that a printer would only support the
* OrientationRequested attribute for some document formats (e.g.,
! * {@code "text/plain"} or {@code "text/html"}) but not others (e.g.
! * {@code "application/postscript"}). This is no different from any other
* job template attribute, since a print job can always impose constraints
* among the values of different job template attributes.
* However, a special mention
* is made here since it is very likely that a printer will support the
* OrientationRequested attribute for only a subset of the supported document
* formats.
* <P>
* <B>IPP Compatibility:</B> The category name returned by
! * {@code getName()} is the IPP attribute name. The enumeration's
! * integer value is the IPP enum value. The {@code toString()} method
* returns the IPP string representation of the attribute value.
*
* @author Alan Kaminsky
*/
public final class OrientationRequested extends EnumSyntax
*** 103,113 ****
* respect to the medium from the portrait orientation. <I>Note:</I> The
* REVERSE_PORTRAIT value was added for use with the {@link
* Finishings Finishings} attribute in cases where the
* opposite edge is desired for finishing a portrait document on simple
* finishing devices that have only one finishing position. Thus a
! * <CODE>"text/plain"</CODE> portrait document can be stapled "on the
* right" by a simple finishing device as is common use with some
* Middle Eastern languages such as Hebrew.
*/
public static final OrientationRequested
REVERSE_PORTRAIT = new OrientationRequested(6);
--- 103,113 ----
* respect to the medium from the portrait orientation. <I>Note:</I> The
* REVERSE_PORTRAIT value was added for use with the {@link
* Finishings Finishings} attribute in cases where the
* opposite edge is desired for finishing a portrait document on simple
* finishing devices that have only one finishing position. Thus a
! * {@code "text/plain"} portrait document can be stapled "on the
* right" by a simple finishing device as is common use with some
* Middle Eastern languages such as Hebrew.
*/
public static final OrientationRequested
REVERSE_PORTRAIT = new OrientationRequested(6);
*** 174,184 ****
/**
* Get the name of the category of which this attribute value is an
* instance.
* <P>
* For class OrientationRequested, the
! * category name is <CODE>"orientation-requested"</CODE>.
*
* @return Attribute category name.
*/
public final String getName() {
return "orientation-requested";
--- 174,184 ----
/**
* Get the name of the category of which this attribute value is an
* instance.
* <P>
* For class OrientationRequested, the
! * category name is {@code "orientation-requested"}.
*
* @return Attribute category name.
*/
public final String getName() {
return "orientation-requested";
< prev index next >