< prev index next >

src/java.desktop/share/classes/javax/print/attribute/standard/MultipleDocumentHandling.java

Print this page

        

*** 60,116 **** * separate output document to produce. The MultipleDocumentHandling values * SEPARATE_DOCUMENTS_UNCOLLATED_COPIES and SEPARATE_DOCUMENTS_COLLATED_COPIES * specify two variations of this possibility. * </UL> * <P> ! * In the detailed explanations below, if "<CODE>a</CODE>" represents an * instance of document data, then the result of processing the data in ! * document "<CODE>a</CODE>" is a sequence of media sheets represented by ! * "<CODE>a(*)</CODE>". * <P> * The standard MultipleDocumentHandling values are: * <UL> * <LI> * <a NAME="sdfi"></a>{@link #SINGLE_DOCUMENT * <B>SINGLE_DOCUMENT</B>}. If a print job has multiple ! * documents -- say, the document data is called <CODE>a</CODE> and ! * <CODE>b</CODE> -- then the result of processing all the document data ! * (<CODE>a</CODE> and then <CODE>b</CODE>) must be treated as a single sequence * of media sheets for finishing operations; that is, finishing would be ! * performed on the concatenation of the sequences <CODE>a(*),b(*)</CODE>. The * printer must not force the data in each document instance to be formatted * onto a new print-stream page, nor to start a new impression on a new media * sheet. If more than one copy is made, the ordering of the sets of media * sheets resulting from processing the document data must be ! * <CODE>a(*),b(*),a(*),b(*),...</CODE>, and the printer object must force ! * each copy (<CODE>a(*),b(*)</CODE>) to start on a new media sheet. * * <LI> * <a NAME="sducfi"></a>{@link #SEPARATE_DOCUMENTS_UNCOLLATED_COPIES * <B>SEPARATE_DOCUMENTS_UNCOLLATED_COPIES</B>}. If a print job ! * has multiple documents -- say, the document data is called <CODE>a</CODE> and ! * <CODE>b</CODE> -- then the result of processing the data in each document * instance must be treated as a single sequence of media sheets for finishing ! * operations; that is, the sets <CODE>a(*)</CODE> and <CODE>b(*)</CODE> would * each be finished separately. The printer must force each copy of the result * of processing the data in a single document to start on a new media sheet. * If more than one copy is made, the ordering of the sets of media sheets * resulting from processing the document data must be ! * <CODE>a(*),a(*),...,b(*),b(*)...</CODE>. * * <LI> * <a NAME="sdccfi"></a>{@link #SEPARATE_DOCUMENTS_COLLATED_COPIES * <B>SEPARATE_DOCUMENTS_COLLATED_COPIES</B>}. If a print job ! * has multiple documents -- say, the document data is called <CODE>a</CODE> and ! * <CODE>b</CODE> -- then the result of processing the data in each document * instance must be treated as a single sequence of media sheets for finishing ! * operations; that is, the sets <CODE>a(*)</CODE> and <CODE>b(*)</CODE> would * each be finished separately. The printer must force each copy of the result * of processing the data in a single document to start on a new media sheet. * If more than one copy is made, the ordering of the sets of media sheets * resulting from processing the document data must be ! * <CODE>a(*),b(*),a(*),b(*),...</CODE>. * * <LI> * <a NAME="sdnsfi"></a>{@link #SINGLE_DOCUMENT_NEW_SHEET * <B>SINGLE_DOCUMENT_NEW_SHEET</B>}. Same as SINGLE_DOCUMENT, * except that the printer must ensure that the first impression of each --- 60,116 ---- * separate output document to produce. The MultipleDocumentHandling values * SEPARATE_DOCUMENTS_UNCOLLATED_COPIES and SEPARATE_DOCUMENTS_COLLATED_COPIES * specify two variations of this possibility. * </UL> * <P> ! * In the detailed explanations below, if "{@code a}" represents an * instance of document data, then the result of processing the data in ! * document "{@code a}" is a sequence of media sheets represented by ! * "{@code a(*)}". * <P> * The standard MultipleDocumentHandling values are: * <UL> * <LI> * <a NAME="sdfi"></a>{@link #SINGLE_DOCUMENT * <B>SINGLE_DOCUMENT</B>}. If a print job has multiple ! * documents -- say, the document data is called {@code a} and ! * {@code b} -- then the result of processing all the document data ! * ({@code a} and then {@code b}) must be treated as a single sequence * of media sheets for finishing operations; that is, finishing would be ! * performed on the concatenation of the sequences {@code a(*),b(*)}. The * printer must not force the data in each document instance to be formatted * onto a new print-stream page, nor to start a new impression on a new media * sheet. If more than one copy is made, the ordering of the sets of media * sheets resulting from processing the document data must be ! * {@code a(*),b(*),a(*),b(*),...}, and the printer object must force ! * each copy ({@code a(*),b(*)}) to start on a new media sheet. * * <LI> * <a NAME="sducfi"></a>{@link #SEPARATE_DOCUMENTS_UNCOLLATED_COPIES * <B>SEPARATE_DOCUMENTS_UNCOLLATED_COPIES</B>}. If a print job ! * has multiple documents -- say, the document data is called {@code a} and ! * {@code b} -- then the result of processing the data in each document * instance must be treated as a single sequence of media sheets for finishing ! * operations; that is, the sets {@code a(*)} and {@code b(*)} would * each be finished separately. The printer must force each copy of the result * of processing the data in a single document to start on a new media sheet. * If more than one copy is made, the ordering of the sets of media sheets * resulting from processing the document data must be ! * {@code a(*),a(*),...,b(*),b(*)...}. * * <LI> * <a NAME="sdccfi"></a>{@link #SEPARATE_DOCUMENTS_COLLATED_COPIES * <B>SEPARATE_DOCUMENTS_COLLATED_COPIES</B>}. If a print job ! * has multiple documents -- say, the document data is called {@code a} and ! * {@code b} -- then the result of processing the data in each document * instance must be treated as a single sequence of media sheets for finishing ! * operations; that is, the sets {@code a(*)} and {@code b(*)} would * each be finished separately. The printer must force each copy of the result * of processing the data in a single document to start on a new media sheet. * If more than one copy is made, the ordering of the sets of media sheets * resulting from processing the document data must be ! * {@code a(*),b(*),a(*),b(*),...}. * * <LI> * <a NAME="sdnsfi"></a>{@link #SINGLE_DOCUMENT_NEW_SHEET * <B>SINGLE_DOCUMENT_NEW_SHEET</B>}. Same as SINGLE_DOCUMENT, * except that the printer must ensure that the first impression of each
*** 128,159 **** * <P> * In addition, if a {@link Finishings Finishings} attribute of * {@link Finishings#STAPLE STAPLE} is specified, then: * <UL> * <LI> ! * With SINGLE_DOCUMENT, documents <CODE>a</CODE> and <CODE>b</CODE> are * stapled together as a single document with no regard to new sheets. * * <LI> ! * With SINGLE_DOCUMENT_NEW_SHEET, documents <CODE>a</CODE> and <CODE>b</CODE> ! * are stapled together as a single document, but document <CODE>b</CODE> * starts on a new sheet. * * <LI> * With SEPARATE_DOCUMENTS_UNCOLLATED_COPIES and ! * SEPARATE_DOCUMENTS_COLLATED_COPIES, documents <CODE>a</CODE> and ! * <CODE>b</CODE> are stapled separately. * </UL> * <P> * <I>Note:</I> None of these values provide means to produce uncollated * sheets within a document, i.e., where multiple copies of sheet <I>n</I> * are produced before sheet <I>n</I>+1 of the same document. * To specify that, see the {@link SheetCollate SheetCollate} attribute. * <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. * * @see Copies * @see Finishings * @see NumberUp --- 128,159 ---- * <P> * In addition, if a {@link Finishings Finishings} attribute of * {@link Finishings#STAPLE STAPLE} is specified, then: * <UL> * <LI> ! * With SINGLE_DOCUMENT, documents {@code a} and {@code b} are * stapled together as a single document with no regard to new sheets. * * <LI> ! * With SINGLE_DOCUMENT_NEW_SHEET, documents {@code a} and {@code b} ! * are stapled together as a single document, but document {@code b} * starts on a new sheet. * * <LI> * With SEPARATE_DOCUMENTS_UNCOLLATED_COPIES and ! * SEPARATE_DOCUMENTS_COLLATED_COPIES, documents {@code a} and ! * {@code b} are stapled separately. * </UL> * <P> * <I>Note:</I> None of these values provide means to produce uncollated * sheets within a document, i.e., where multiple copies of sheet <I>n</I> * are produced before sheet <I>n</I>+1 of the same document. * To specify that, see the {@link SheetCollate SheetCollate} attribute. * <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. * * @see Copies * @see Finishings * @see NumberUp
*** 254,264 **** /** * Get the name of the category of which this attribute value is an * instance. * <P> * For class MultipleDocumentHandling and any vendor-defined subclasses, ! * the category name is <CODE>"multiple-document-handling"</CODE>. * * @return Attribute category name. */ public final String getName() { return "multiple-document-handling"; --- 254,264 ---- /** * Get the name of the category of which this attribute value is an * instance. * <P> * For class MultipleDocumentHandling and any vendor-defined subclasses, ! * the category name is {@code "multiple-document-handling"}. * * @return Attribute category name. */ public final String getName() { return "multiple-document-handling";
< prev index next >