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