<- JMXServiceURL JobAttributes.DestinationType ->

API java : JobAttributes

java.awt
Class JobAttributes

java.lang.Object
  java.awt.JobAttributes

All Implemented Interfaces:: Cloneable

public final class JobAttributes
extends Object
implements Cloneable
extends Object
implements Cloneable

A set of attributes which control a print job.

Instances of this class control the number of copies, default selection, destination, print dialog, file and printer names, page ranges, multiple document handling (including collation), and multi-page imposition (such as duplex) of every print job which uses the instance. Attribute names are compliant with the Internet Printing Protocol (IPP) 1.1 where possible. Attribute values are partially compliant where possible.

To use a method which takes an inner class type, pass a reference to one of the constant fields of the inner class. Client code cannot create new instances of the inner class types because none of those classes has a public constructor. For example, to set the print dialog type to the cross-platform, pure Java print dialog, use the following code:

import java.awt.JobAttributes;
 
 public class PureJavaPrintDialogExample {
     public void setPureJavaPrintDialog(JobAttributes jobAttributes) {
         jobAttributes.setDialog(JobAttributes.DialogType.COMMON);
     }
 }

Every IPP attribute which supports an attributeName-default value has a corresponding setattributeNameToDefault method. Default value fields are not provided.

Nested Class Summary

static class JobAttributes.DefaultSelectionType
          A type-safe enumeration of possible default selection states.

static class JobAttributes.DestinationType
          A type-safe enumeration of possible job destinations.

static class JobAttributes.DialogType
          A type-safe enumeration of possible dialogs to display to the user.

static class JobAttributes.MultipleDocumentHandlingType
          A type-safe enumeration of possible multiple copy handling states.

static class JobAttributes.SidesType
          A type-safe enumeration of possible multi-page impositions.

Constructor Summary

JobAttributes()
          Constructs a JobAttributes instance with default values for every attribute.

JobAttributes(int copies, JobAttributes.DefaultSelectionType defaultSelection, JobAttributes.DestinationType destination, JobAttributes.DialogType dialog, String fileName, int maxPage, int minPage, JobAttributes.MultipleDocumentHandlingType multipleDocumentHandling, int[][] pageRanges, String printer, JobAttributes.SidesType sides)
          Constructs a JobAttributes instance with the specified values for every attribute.

JobAttributes(JobAttributes obj)
          Constructs a JobAttributes instance which is a copy of the supplied JobAttributes.

Method Summary

Object clone()
          Creates and returns a copy of this JobAttributes.

boolean equals(Object obj)
          Determines whether two JobAttributes are equal to each other.

int getCopies()
          Returns the number of copies the application should render for jobs using these attributes.

JobAttributes.DefaultSelectionType getDefaultSelection()
          Specifies whether, for jobs using these attributes, the application should print all pages, the range specified by the return value of getPageRanges, or the current selection.

JobAttributes.DestinationType getDestination()
          Specifies whether output will be to a printer or a file for jobs using these attributes.

JobAttributes.DialogType getDialog()
          Returns whether, for jobs using these attributes, the user should see a print dialog in which to modify the print settings, and which type of print dialog should be displayed.

String getFileName()
          Specifies the file name for the output file for jobs using these attributes.

int getFromPage()
          Returns, for jobs using these attributes, the first page to be printed, if a range of pages is to be printed.

int getMaxPage()
          Specifies the maximum value the user can specify as the last page to be printed for jobs using these attributes.

int getMinPage()
          Specifies the minimum value the user can specify as the first page to be printed for jobs using these attributes.

JobAttributes.MultipleDocumentHandlingType getMultipleDocumentHandling()
          Specifies the handling of multiple copies, including collation, for jobs using these attributes.

int[][] getPageRanges()
          Specifies, for jobs using these attributes, the ranges of pages to be printed, if a range of pages is to be printed.

String getPrinter()
          Returns the destination printer for jobs using these attributes.

JobAttributes.SidesType getSides()
          Returns how consecutive pages should be imposed upon the sides of the print medium for jobs using these attributes.

int getToPage()
          Returns, for jobs using these attributes, the last page (inclusive) to be printed, if a range of pages is to be printed.

int hashCode()
          Returns a hash code value for this JobAttributes.

void set(JobAttributes obj)
          Sets all of the attributes of this JobAttributes to the same values as the attributes of obj.

void setCopies(int copies)
          Specifies the number of copies the application should render for jobs using these attributes.

void setCopiesToDefault()
          Sets the number of copies the application should render for jobs using these attributes to the default.

void setDefaultSelection(JobAttributes.DefaultSelectionType defaultSelection)
          Specifies whether, for jobs using these attributes, the application should print all pages, the range specified by the return value of getPageRanges, or the current selection.

void setDestination(JobAttributes.DestinationType destination)
          Specifies whether output will be to a printer or a file for jobs using these attributes.

void setDialog(JobAttributes.DialogType dialog)
          Specifies whether, for jobs using these attributes, the user should see a print dialog in which to modify the print settings, and which type of print dialog should be displayed.

void setFileName(String fileName)
          Specifies the file name for the output file for jobs using these attributes.

void setFromPage(int fromPage)
          Specifies, for jobs using these attributes, the first page to be printed, if a range of pages is to be printed.

void setMaxPage(int maxPage)
          Specifies the maximum value the user can specify as the last page to be printed for jobs using these attributes.

void setMinPage(int minPage)
          Specifies the minimum value the user can specify as the first page to be printed for jobs using these attributes.

void
setMultipleDocumentHandling( JobAttributes.MultipleDocumentHandlingType multipleDocumentHandling )

          Specifies the handling of multiple copies, including collation, for jobs using these attributes.

void setMultipleDocumentHandlingToDefault()
          Sets the handling of multiple copies, including collation, for jobs using these attributes to the default.

void setPageRanges(int[][] pageRanges)
          Specifies, for jobs using these attributes, the ranges of pages to be printed, if a range of pages is to be printed.

void setPrinter(String printer)
          Specifies the destination printer for jobs using these attributes.

void setSides(JobAttributes.SidesType sides)
          Specifies how consecutive pages should be imposed upon the sides of the print medium for jobs using these attributes.

void setSidesToDefault()
          Sets how consecutive pages should be imposed upon the sides of the print medium for jobs using these attributes to the default.

void setToPage(int toPage)
          Specifies, for jobs using these attributes, the last page (inclusive) to be printed, if a range of pages is to be printed.

String toString()
          Returns a string representation of this JobAttributes.

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Nested Class Summary
`static class`	`JobAttributes.DefaultSelectionType` A type-safe enumeration of possible default selection states.
`static class`	`JobAttributes.DestinationType` A type-safe enumeration of possible job destinations.
`static class`	`JobAttributes.DialogType` A type-safe enumeration of possible dialogs to display to the user.
`static class`	`JobAttributes.MultipleDocumentHandlingType` A type-safe enumeration of possible multiple copy handling states.
`static class`	`JobAttributes.SidesType` A type-safe enumeration of possible multi-page impositions.

Constructor Summary
`JobAttributes()` Constructs a `JobAttributes` instance with default values for every attribute.
`JobAttributes(int copies, JobAttributes.DefaultSelectionType defaultSelection, JobAttributes.DestinationType destination, JobAttributes.DialogType dialog, String fileName, int maxPage, int minPage, JobAttributes.MultipleDocumentHandlingType multipleDocumentHandling, int[][] pageRanges, String printer, JobAttributes.SidesType sides)` Constructs a `JobAttributes` instance with the specified values for every attribute.
`JobAttributes(JobAttributes obj)` Constructs a `JobAttributes` instance which is a copy of the supplied `JobAttributes`.

Method Summary
`Object`	`clone()` Creates and returns a copy of this `JobAttributes`.
`boolean`	`equals(Object obj)` Determines whether two JobAttributes are equal to each other.
`int`	`getCopies()` Returns the number of copies the application should render for jobs using these attributes.
`JobAttributes.DefaultSelectionType`	`getDefaultSelection()` Specifies whether, for jobs using these attributes, the application should print all pages, the range specified by the return value of `getPageRanges`, or the current selection.
`JobAttributes.DestinationType`	`getDestination()` Specifies whether output will be to a printer or a file for jobs using these attributes.
`JobAttributes.DialogType`	`getDialog()` Returns whether, for jobs using these attributes, the user should see a print dialog in which to modify the print settings, and which type of print dialog should be displayed.
`String`	`getFileName()` Specifies the file name for the output file for jobs using these attributes.
`int`	`getFromPage()` Returns, for jobs using these attributes, the first page to be printed, if a range of pages is to be printed.
`int`	`getMaxPage()` Specifies the maximum value the user can specify as the last page to be printed for jobs using these attributes.
`int`	`getMinPage()` Specifies the minimum value the user can specify as the first page to be printed for jobs using these attributes.
`JobAttributes.MultipleDocumentHandlingType`	`getMultipleDocumentHandling()` Specifies the handling of multiple copies, including collation, for jobs using these attributes.
`int[][]`	`getPageRanges()` Specifies, for jobs using these attributes, the ranges of pages to be printed, if a range of pages is to be printed.
`String`	`getPrinter()` Returns the destination printer for jobs using these attributes.
`JobAttributes.SidesType`	`getSides()` Returns how consecutive pages should be imposed upon the sides of the print medium for jobs using these attributes.
`int`	`getToPage()` Returns, for jobs using these attributes, the last page (inclusive) to be printed, if a range of pages is to be printed.
`int`	`hashCode()` Returns a hash code value for this JobAttributes.
`void`	`set(JobAttributes obj)` Sets all of the attributes of this `JobAttributes` to the same values as the attributes of obj.
`void`	`setCopies(int copies)` Specifies the number of copies the application should render for jobs using these attributes.
`void`	`setCopiesToDefault()` Sets the number of copies the application should render for jobs using these attributes to the default.
`void`	`setDefaultSelection(JobAttributes.DefaultSelectionType defaultSelection)` Specifies whether, for jobs using these attributes, the application should print all pages, the range specified by the return value of `getPageRanges`, or the current selection.
`void`	`setDestination(JobAttributes.DestinationType destination)` Specifies whether output will be to a printer or a file for jobs using these attributes.
`void`	`setDialog(JobAttributes.DialogType dialog)` Specifies whether, for jobs using these attributes, the user should see a print dialog in which to modify the print settings, and which type of print dialog should be displayed.
`void`	`setFileName(String fileName)` Specifies the file name for the output file for jobs using these attributes.
`void`	`setFromPage(int fromPage)` Specifies, for jobs using these attributes, the first page to be printed, if a range of pages is to be printed.
`void`	`setMaxPage(int maxPage)` Specifies the maximum value the user can specify as the last page to be printed for jobs using these attributes.
`void`	`setMinPage(int minPage)` Specifies the minimum value the user can specify as the first page to be printed for jobs using these attributes.
`void`	`setMultipleDocumentHandling( JobAttributes.MultipleDocumentHandlingType multipleDocumentHandling )` Specifies the handling of multiple copies, including collation, for jobs using these attributes.
`void`	`setMultipleDocumentHandlingToDefault()` Sets the handling of multiple copies, including collation, for jobs using these attributes to the default.
`void`	`setPageRanges(int[][] pageRanges)` Specifies, for jobs using these attributes, the ranges of pages to be printed, if a range of pages is to be printed.
`void`	`setPrinter(String printer)` Specifies the destination printer for jobs using these attributes.
`void`	`setSides(JobAttributes.SidesType sides)` Specifies how consecutive pages should be imposed upon the sides of the print medium for jobs using these attributes.
`void`	`setSidesToDefault()` Sets how consecutive pages should be imposed upon the sides of the print medium for jobs using these attributes to the default.
`void`	`setToPage(int toPage)` Specifies, for jobs using these attributes, the last page (inclusive) to be printed, if a range of pages is to be printed.
`String`	`toString()` Returns a string representation of this JobAttributes.

Methods inherited from class java.lang.Object
`finalize, getClass, notify, notifyAll, wait, wait, wait`

Constructor Detail

JobAttributes

public JobAttributes()

Constructs a JobAttributes instance with default values for every attribute. The dialog defaults to DialogType.NATIVE. Min page defaults to 1. Max page defaults to Integer.MAX_VALUE. Destination defaults to DestinationType.PRINTER. Selection defaults to DefaultSelectionType.ALL. Number of copies defaults to 1. Multiple document handling defaults to MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES. Sides defaults to SidesType.ONE_SIDED. File name defaults to null.

JobAttributes

public JobAttributes(JobAttributes obj)

Constructs a JobAttributes instance which is a copy of the supplied JobAttributes.

Parameters:: obj - the JobAttributes to copy

JobAttributes

public JobAttributes(int copies,
                     JobAttributes.DefaultSelectionType defaultSelection,
                     JobAttributes.DestinationType destination,
                     JobAttributes.DialogType dialog,
                     String fileName,
                     int maxPage,
                     int minPage,
                     JobAttributes.MultipleDocumentHandlingType multipleDocumentHandling,
                     int[][] pageRanges,
                     String printer,
                     JobAttributes.SidesType sides)

Constructs a JobAttributes instance with the specified values for every attribute.

Parameters:

copies - an integer greater than 0

defaultSelection - DefaultSelectionType.ALL, DefaultSelectionType.RANGE, or DefaultSelectionType.SELECTION

destination - DesintationType.FILE or DesintationType.PRINTER

dialog - DialogType.COMMON, DialogType.NATIVE, or DialogType.NONE

fileName - the possibly null file name

maxPage - an integer greater than zero and greater than or equal to minPage

minPage - an integer greater than zero and less than or equal to maxPage

multipleDocumentHandling - MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_COLLATED_COPIES or MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES

pageRanges - an array of integer arrays of two elements; an array is interpreted as a range spanning all pages including and between the specified pages; ranges must be in ascending order and must not overlap; specified page numbers cannot be less than minPage nor greater than maxPage; for example:

(new int[][] { new int[] { 1, 3 }, new int[] { 5, 5 },
                               new int[] { 15, 19 } }),

specifies pages 1, 2, 3, 5, 15, 16, 17, 18, and 19. Note that (new int[][] { new int[] { 1, 1 }, new int[] { 1, 2 } }), is an invalid set of page ranges because the two ranges overlap

printer - the possibly null printer name

sides - SidesType.ONE_SIDED, SidesType.TWO_SIDED_LONG_EDGE, or SidesType.TWO_SIDED_SHORT_EDGE

Throws:

IllegalArgumentException - if one or more of the above conditions is violated

Method Detail

clone

public Object clone()

Creates and returns a copy of this JobAttributes.

Overrides:: clone in class Object

Returns:: the newly created copy; it is safe to cast this Object into a JobAttributes
See Also:: Cloneable

set

public void set(JobAttributes obj)

Sets all of the attributes of this JobAttributes to the same values as the attributes of obj.

Parameters:: obj - the JobAttributes to copy

getCopies

public int getCopies()

Returns the number of copies the application should render for jobs using these attributes. This attribute is updated to the value chosen by the user.

Returns:: an integer greater than 0.

setCopies

public void setCopies(int copies)

Specifies the number of copies the application should render for jobs using these attributes. Not specifying this attribute is equivalent to specifying 1.

Parameters:: copies - an integer greater than 0
Throws:: IllegalArgumentException - if copies is less than or equal to 0

setCopiesToDefault

public void setCopiesToDefault()

Sets the number of copies the application should render for jobs using these attributes to the default. The default number of copies is 1.

getDefaultSelection

public JobAttributes.DefaultSelectionType getDefaultSelection()

Specifies whether, for jobs using these attributes, the application should print all pages, the range specified by the return value of getPageRanges, or the current selection. This attribute is updated to the value chosen by the user.

Returns:: DefaultSelectionType.ALL, DefaultSelectionType.RANGE, or DefaultSelectionType.SELECTION

setDefaultSelection

public void setDefaultSelection(JobAttributes.DefaultSelectionType defaultSelection)

Specifies whether, for jobs using these attributes, the application should print all pages, the range specified by the return value of getPageRanges, or the current selection. Not specifying this attribute is equivalent to specifying DefaultSelectionType.ALL.

Parameters:: defaultSelection - DefaultSelectionType.ALL, DefaultSelectionType.RANGE, or DefaultSelectionType.SELECTION.
Throws:: IllegalArgumentException - if defaultSelection is null

getDestination

public JobAttributes.DestinationType getDestination()

Specifies whether output will be to a printer or a file for jobs using these attributes. This attribute is updated to the value chosen by the user.

Returns:: DesintationType.FILE or DesintationType.PRINTER

setDestination

public void setDestination(JobAttributes.DestinationType destination)

Specifies whether output will be to a printer or a file for jobs using these attributes. Not specifying this attribute is equivalent to specifying DesintationType.PRINTER.

Parameters:: destination - DesintationType.FILE or DesintationType.PRINTER.
Throws:: IllegalArgumentException - if destination is null.

getDialog

public JobAttributes.DialogType getDialog()

Returns whether, for jobs using these attributes, the user should see a print dialog in which to modify the print settings, and which type of print dialog should be displayed. DialogType.COMMON denotes a cross- platform, pure Java print dialog. DialogType.NATIVE denotes the platform's native print dialog. If a platform does not support a native print dialog, the pure Java print dialog is displayed instead. DialogType.NONE specifies no print dialog (i.e., background printing). This attribute cannot be modified by, and is not subject to any limitations of, the implementation or the target printer.

Returns:: DialogType.COMMON, DialogType.NATIVE, or DialogType.NONE

setDialog

public void setDialog(JobAttributes.DialogType dialog)

Specifies whether, for jobs using these attributes, the user should see a print dialog in which to modify the print settings, and which type of print dialog should be displayed. DialogType.COMMON denotes a cross- platform, pure Java print dialog. DialogType.NATIVE denotes the platform's native print dialog. If a platform does not support a native print dialog, the pure Java print dialog is displayed instead. DialogType.NONE specifies no print dialog (i.e., background printing). Not specifying this attribute is equivalent to specifying DialogType.NATIVE.

Parameters:: dialog - DialogType.COMMON, DialogType.NATIVE, or DialogType.NONE.
Throws:: IllegalArgumentException - if dialog is null.

getFileName

public String getFileName()

Specifies the file name for the output file for jobs using these attributes. This attribute is updated to the value chosen by the user.

Returns:: the possibly null file name

setFileName

public void setFileName(String fileName)

Specifies the file name for the output file for jobs using these attributes. Default is platform-dependent and implementation-defined.

Parameters:: fileName - the possibly null file name.

getFromPage

public int getFromPage()

Returns, for jobs using these attributes, the first page to be printed, if a range of pages is to be printed. This attribute is updated to the value chosen by the user. An application should ignore this attribute on output, unless the return value of the


 getDefaultSelection

method is DefaultSelectionType.RANGE. An application should honor the return value of getPageRanges over the return value of this method, if possible.

Returns:: an integer greater than zero and less than or equal to toPage and greater than or equal to minPage and less than or equal to maxPage.

setFromPage

public void setFromPage(int fromPage)

Specifies, for jobs using these attributes, the first page to be printed, if a range of pages is to be printed. If this attribute is not specified, then the values from the pageRanges attribute are used. If pageRanges and either or both of fromPage and toPage are specified, pageRanges takes precedence. Specifying none of pageRanges, fromPage, or toPage is equivalent to calling setPageRanges(new int[][] { new int[] { minPage } });

Parameters:: fromPage - an integer greater than zero and less than or equal to toPage and greater than or equal to minPage and less than or equal to maxPage.
Throws:: IllegalArgumentException - if one or more of the above conditions is violated.

getMaxPage

public int getMaxPage()

Specifies the maximum value the user can specify as the last page to be printed for jobs using these attributes. This attribute cannot be modified by, and is not subject to any limitations of, the implementation or the target printer.

Returns:: an integer greater than zero and greater than or equal to minPage.

setMaxPage

public void setMaxPage(int maxPage)

Specifies the maximum value the user can specify as the last page to be printed for jobs using these attributes. Not specifying this attribute is equivalent to specifying Integer.MAX_VALUE.

Parameters:: maxPage - an integer greater than zero and greater than or equal to minPage
Throws:: IllegalArgumentException - if one or more of the above conditions is violated

getMinPage

public int getMinPage()

Specifies the minimum value the user can specify as the first page to be printed for jobs using these attributes. This attribute cannot be modified by, and is not subject to any limitations of, the implementation or the target printer.

Returns:: an integer greater than zero and less than or equal to maxPage.

setMinPage

public void setMinPage(int minPage)

Specifies the minimum value the user can specify as the first page to be printed for jobs using these attributes. Not specifying this attribute is equivalent to specifying 1.

Parameters:: minPage - an integer greater than zero and less than or equal to maxPage.
Throws:: IllegalArgumentException - if one or more of the above conditions is violated.

getMultipleDocumentHandling

public JobAttributes.MultipleDocumentHandlingType getMultipleDocumentHandling()

Specifies the handling of multiple copies, including collation, for jobs using these attributes. This attribute is updated to the value chosen by the user.

Returns:: MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_COLLATED_COPIES or MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES.

setMultipleDocumentHandling

public void setMultipleDocumentHandling(
	JobAttributes.MultipleDocumentHandlingType multipleDocumentHandling
	)

Specifies the handling of multiple copies, including collation, for jobs using these attributes. Not specifying this attribute is equivalent to specifying MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES.

Parameters:: multipleDocumentHandling - MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_COLLATED_COPIES or MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES.
Throws:: IllegalArgumentException - if multipleDocumentHandling is null.

setMultipleDocumentHandlingToDefault

public void setMultipleDocumentHandlingToDefault()

Sets the handling of multiple copies, including collation, for jobs using these attributes to the default. The default handling is MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES.

getPageRanges

public int[][] getPageRanges()

Specifies, for jobs using these attributes, the ranges of pages to be printed, if a range of pages is to be printed. All range numbers are inclusive. This attribute is updated to the value chosen by the user. An application should ignore this attribute on output, unless the return value of the getDefaultSelection method is DefaultSelectionType.RANGE.

Returns:: an array of integer arrays of 2 elements. An array is interpreted as a range spanning all pages including and between the specified pages. Ranges must be in ascending order and must not overlap. Specified page numbers cannot be less than minPage nor greater than maxPage. For example: (new int[][] { new int[] { 1, 3 }, new int[] { 5, 5 }, new int[] { 15, 19 } }), specifies pages 1, 2, 3, 5, 15, 16, 17, 18, and 19.

setPageRanges

public void setPageRanges(int[][] pageRanges)

Specifies, for jobs using these attributes, the ranges of pages to be printed, if a range of pages is to be printed. All range numbers are inclusive. If this attribute is not specified, then the values from the fromPage and toPages attributes are used. If pageRanges and either or both of fromPage and toPage are specified, pageRanges takes precedence. Specifying none of pageRanges, fromPage, or toPage is equivalent to calling setPageRanges(new int[][] { new int[] { minPage, minPage } });

Parameters:: pageRanges - an array of integer arrays of 2 elements. An array is interpreted as a range spanning all pages including and between the specified pages. Ranges must be in ascending order and must not overlap. Specified page numbers cannot be less than minPage nor greater than maxPage. For example: (new int[][] { new int[] { 1, 3 }, new int[] { 5, 5 }, new int[] { 15, 19 } }), specifies pages 1, 2, 3, 5, 15, 16, 17, 18, and 19. Note that (new int[][] { new int[] { 1, 1 }, new int[] { 1, 2 } }), is an invalid set of page ranges because the two ranges overlap.
Throws:: IllegalArgumentException - if one or more of the above conditions is violated.

getPrinter

public String getPrinter()

Returns the destination printer for jobs using these attributes. This attribute is updated to the value chosen by the user.

Returns:: the possibly null printer name.

setPrinter

public void setPrinter(String printer)

Specifies the destination printer for jobs using these attributes. Default is platform-dependent and implementation-defined.

Parameters:: printer - the possibly null printer name.

getSides

public JobAttributes.SidesType getSides()

Returns how consecutive pages should be imposed upon the sides of the print medium for jobs using these attributes. SidesType.ONE_SIDED imposes each consecutive page upon the same side of consecutive media sheets. This imposition is sometimes called simplex. SidesType.TWO_SIDED_LONG_EDGE imposes each consecutive pair of pages upon front and back sides of consecutive media sheets, such that the orientation of each pair of pages on the medium would be correct for the reader as if for binding on the long edge. This imposition is sometimes called duplex. SidesType.TWO_SIDED_SHORT_EDGE imposes each consecutive pair of pages upon front and back sides of consecutive media sheets, such that the orientation of each pair of pages on the medium would be correct for the reader as if for binding on the short edge. This imposition is sometimes called tumble. This attribute is updated to the value chosen by the user.

Returns:: SidesType.ONE_SIDED, SidesType.TWO_SIDED_LONG_EDGE, or SidesType.TWO_SIDED_SHORT_EDGE.

setSides

public void setSides(JobAttributes.SidesType sides)

Specifies how consecutive pages should be imposed upon the sides of the print medium for jobs using these attributes. SidesType.ONE_SIDED imposes each consecutive page upon the same side of consecutive media sheets. This imposition is sometimes called simplex. SidesType.TWO_SIDED_LONG_EDGE imposes each consecutive pair of pages upon front and back sides of consecutive media sheets, such that the orientation of each pair of pages on the medium would be correct for the reader as if for binding on the long edge. This imposition is sometimes called duplex. SidesType.TWO_SIDED_SHORT_EDGE imposes each consecutive pair of pages upon front and back sides of consecutive media sheets, such that the orientation of each pair of pages on the medium would be correct for the reader as if for binding on the short edge. This imposition is sometimes called tumble. Not specifying this attribute is equivalent to specifying SidesType.ONE_SIDED.

Parameters:: sides - SidesType.ONE_SIDED, SidesType.TWO_SIDED_LONG_EDGE, or SidesType.TWO_SIDED_SHORT_EDGE.
Throws:: IllegalArgumentException - if sides is null.

setSidesToDefault

public void setSidesToDefault()

Sets how consecutive pages should be imposed upon the sides of the print medium for jobs using these attributes to the default. The default imposition is SidesType.ONE_SIDED.

getToPage

public int getToPage()

Returns, for jobs using these attributes, the last page (inclusive) to be printed, if a range of pages is to be printed. This attribute is updated to the value chosen by the user. An application should ignore this attribute on output, unless the return value of the


 getDefaultSelection

method is DefaultSelectionType.RANGE. An application should honor the return value of getPageRanges over the return value of this method, if possible.

Returns:: an integer greater than zero and greater than or equal to toPage and greater than or equal to minPage and less than or equal to maxPage.

setToPage

public void setToPage(int toPage)

Specifies, for jobs using these attributes, the last page (inclusive) to be printed, if a range of pages is to be printed. If this attribute is not specified, then the values from the pageRanges attribute are used. If pageRanges and either or both of fromPage and toPage are specified, pageRanges takes precedence. Specifying none of pageRanges, fromPage, or toPage is equivalent to calling setPageRanges(new int[][] { new int[] { minPage } });

Parameters:: toPage - an integer greater than zero and greater than or equal to fromPage and greater than or equal to minPage and less than or equal to maxPage.
Throws:: IllegalArgumentException - if one or more of the above conditions is violated.

equals

public boolean equals(Object obj)

Determines whether two JobAttributes are equal to each other.

Two JobAttributes are equal if and only if each of their attributes are equal. Attributes of enumeration type are equal if and only if the fields refer to the same unique enumeration object. A set of page ranges is equal if and only if the sets are of equal length, each range enumerates the same pages, and the ranges are in the same order.

Overrides:: equals in class Object

Parameters:: obj - the object whose equality will be checked.
Returns:: whether obj is equal to this JobAttribute according to the above criteria.
See Also:: Object.hashCode(), Hashtable

hashCode

public int hashCode()

Returns a hash code value for this JobAttributes.

Overrides:: hashCode in class Object

Returns:: the hash code.
See Also:: Object.equals(java.lang.Object), Hashtable

toString

public String toString()

Returns a string representation of this JobAttributes.

Overrides:: toString in class Object

Returns:: the string representation.

Package :

Ces informations proviennent du site de http://java.sun.com

Remarques

Contenu

Le contenu de cette page provient du site de Sun, et est généré depuis un cache sur l'infobrol après certains traitements automatisés. La présentation peut donc différer du document original, mais le contenu aussi. Vous pouvez utiliser ce bouton pour afficher la page originale du site de Sun :

Quels sont les motivations de cette démarche?

Maintenir les pages en cache sur différents sites peut offrir plus de disponibilité.

Chaque page est indexée dans la base de donnée, ce qui permet de retrouver facilement les informations, au moyen des sommaires, du moteur de recherche interne, etc.

Des facilités sont mises en place pour que les membres de l'infobrol puissent effectuer des traductions en français des différents documents. Ceci devrait permettre aux débutants en programmation Java de consulter les API en français s'ils maîtrisent moins bien la langue de Shakespeare. Dans le cas où une traduction a été soumise, elle est disponible au moyen d'un lien en bas de page. Si la traduction a été validée, la page s'affiche par défaut en français, et un lien en bas de page permet d'atteindre la version en anglais.

Le code sur l'infobrol est automatiquement coloré selon la syntaxe, et les différents mots clés sont transformés en liens pour accéder rapidement aux informations.

Vous avez la possibilité de partager vos expériences en proposant vos propres extraits de code en utilisant le bouton "ajouter un commentaire" en bas de page. Si vous visitez simplement l'infobrol, vous avez déjà accès à cette fonction, mais si vous étes membre du brol, vous pouvez en plus utiliser des boutons supplémentaires de mise en forme, dont la coloration automatique de vos extraits de codes.

<- JMXServiceURL JobAttributes.DestinationType ->

Réseaux sociaux

|Plus d'options...

Vous pouvez modifier vos préférences dans votre profil pour ne plus afficher les interactions avec les réseaux sociaux sur ces pages.

Nuage de mots clés

6 mots clés dont 0 définis manuellement (plus d'information...).

Avertissement

Cette page ne possède pas encore de mots clés manuels, ceci est donc un exemple automatique (les niveaux de pertinence sont fictifs, mais les liens sont valables). Pour tester le nuage avec une page qui contient des mots définis manuellement, vous pouvez cliquer ici.

Vous pouvez modifier vos préférences dans votre profil pour ne plus afficher le nuage de mots clés.

Structure du document

Réseaux sociaux
Nuage de mots clés
- Avertissement :

Astuce pour imprimer les couleurs des cellules de tableaux : http://www.gaudry.be/ast-rf-450.html

Aucun commentaire pour cette page

tection. Enregistrement IDDN n° 5329-3487
Document créé le 16/09/06 03:44, dernière modification le Vendredi 17 Juin 2011, 12:12
Source du document imprimé : http://www.gaudry.be/java-api-rf-java/awt/JobAttributes.html Document affiché 1 fois ce mois de Juin.
St.Gaudry©07.01.02