< 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 >