Класс JobAttributes

java.lang.Object

java.awt.JobAttributes

Все реализуемые интерфейсы:: Cloneable

public final class JobAttributes extends Object implements Cloneable

Набор атрибутов, контролирующих печать.

Экземпляры этого класса контролируют количество копий, стандартный выбор, место назначения, диалог печати, имена файлов и принтеров, диапазоны страниц, обработку нескольких документов (включая брошюровку), и многостраничную импозицию (например, двустороннюю печать) для каждого задания печати, использующего экземпляр. Имена атрибутов соответствуют протоколу Internet Printing Protocol (IPP) 1.1, где это возможно. Значения атрибутов частично соответствуют протоколу, где это возможно.

Чтобы использовать метод, принимающий внутренний тип класса, передайте ссылку на одно из постоянных полей внутреннего класса. Клиентский код не может создавать новые экземпляры типов внутренних классов, так как ни один из этих классов не имеет публичного конструктора. Например, чтобы установить тип диалога печати на кроссплатформенный, чистый диалог печати Java, используйте следующий код:

 import java.awt.JobAttributes;

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

Каждый атрибут IPP, поддерживающий значение по умолчанию attributeName, имеет соответствующий setattributeNameToDefault метод. Поля значений по умолчанию не предоставляются.

С тех пор:: 1.3

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`static final class`	`JobAttributes.DefaultSelectionType`	Безопасное для типа перечисление возможных состояний стандартного выбора.
`static final class`	`JobAttributes.DestinationType`	Безопасное для типа перечисление возможных мест назначения задания.
`static final class`	`JobAttributes.DialogType`	Безопасное для типа перечисление возможных диалогов для отображения пользователю.
`static final class`	`JobAttributes.MultipleDocumentHandlingType`	Безопасное для типа перечисление возможных состояний обработки нескольких копий.
`static final class`	`JobAttributes.SidesType`	Безопасное для типа перечисление возможных многостраничных импозиций.

Краткое описание конструкторов

Конструктор	Описание
`JobAttributes()`	Конструирует экземпляр `JobAttributes` со значениями по умолчанию для каждого атрибута.
`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)`	Конструирует экземпляр `JobAttributes` со значениями, указанными для каждого атрибута.
`JobAttributes(JobAttributes obj)`	Конструирует экземпляр `JobAttributes`, который является копией предоставленного `JobAttributes`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`Object`	`clone()`	Создает и возвращает копию этого `JobAttributes`.
`boolean`	`equals(Object obj)`	Определяет, равны ли два JobAttributes друг другу.
`int`	`getCopies()`	Возвращает количество копий, которое приложение должно отрисовать для заданий, использующих эти атрибуты.
`JobAttributes.DefaultSelectionType`	`getDefaultSelection()`	Указывает, для заданий, использующих эти атрибуты, должно ли приложение печатать все страницы, диапазон, указанный значением возврата `getPageRanges`, или текущий выбор.
`JobAttributes.DestinationType`	`getDestination()`	Указывает, будет ли вывод на принтер или файл для заданий, использующих эти атрибуты.
`JobAttributes.DialogType`	`getDialog()`	Возвращает, должны ли пользователи увидеть диалог печати, в котором можно изменить параметры печати, и какой тип диалога печати должен быть отображен для заданий, использующих эти атрибуты.
`String`	`getFileName()`	Указывает имя файла выходного файла для заданий, использующих эти атрибуты.
`int`	`getFromPage()`	Возвращает первую страницу для печати, если необходимо печатать диапазон страниц для заданий, использующих эти атрибуты.
`int`	`getMaxPage()`	Указывает максимальное значение, которое пользователь может указать в качестве последней страницы для печати для заданий, использующих эти атрибуты.
`int`	`getMinPage()`	Указывает минимальное значение, которое пользователь может указать в качестве первой страницы для печати для заданий, использующих эти атрибуты.
`JobAttributes.MultipleDocumentHandlingType`	`getMultipleDocumentHandling()`	Указывает обработку нескольких копий, включая брошюровку, для заданий, использующих эти атрибуты.
`int[][]`	`getPageRanges()`	Указывает диапазоны страниц, которые нужно печатать, если нужно печатать диапазон страниц для заданий, использующих эти атрибуты.
`String`	`getPrinter()`	Возвращает принтер назначения для заданий, использующих эти атрибуты.
`JobAttributes.SidesType`	`getSides()`	Возвращает, как последовательные страницы должны быть наложены на стороны носителя печати для заданий, использующих эти атрибуты.
`int`	`getToPage()`	Возвращает последнюю страницу (включительно) для печати, если нужно печатать диапазон страниц для заданий, использующих эти атрибуты.
`int`	`hashCode()`	Возвращает значение хэш-кода для этого JobAttributes.
`void`	`set(JobAttributes obj)`	Устанавливает все атрибуты этого `JobAttributes` в соответствии со значениями атрибутов obj.
`void`	`setCopies(int copies)`	Указывает количество копий, которое приложение должно отрисовать для заданий, использующих эти атрибуты.
`void`	`setCopiesToDefault()`	Устанавливает количество копий, которые приложение должно отрисовать для заданий, использующих эти атрибуты, по умолчанию.
`void`	`setDefaultSelection(JobAttributes.DefaultSelectionType defaultSelection)`	Указывает, для заданий, использующих эти атрибуты, должно ли приложение печатать все страницы, диапазон, указанный значением возврата `getPageRanges`, или текущий выбор.
`void`	`setDestination(JobAttributes.DestinationType destination)`	Указывает, будет ли вывод на принтер или файл для заданий, использующих эти атрибуты.
`void`	`setDialog(JobAttributes.DialogType dialog)`	Указывает, должны ли пользователи увидеть диалог печати, в котором можно изменить параметры печати, и какой тип диалога печати должен быть отображен для заданий, использующих эти атрибуты.
`void`	`setFileName(String fileName)`	Указывает имя файла выходного файла для заданий, использующих эти атрибуты.
`void`	`setFromPage(int fromPage)`	Указывает для заданий, использующих эти атрибуты, первую страницу для печати, если необходимо печатать диапазон страниц.
`void`	`setMaxPage(int maxPage)`	Указывает максимальное значение, которое пользователь может указать в качестве последней страницы для печати для заданий, использующих эти атрибуты.
`void`	`setMinPage(int minPage)`	Указывает минимальное значение, которое пользователь может указать в качестве первой страницы для печати для заданий, использующих эти атрибуты.
`void`	`setMultipleDocumentHandling(JobAttributes.MultipleDocumentHandlingType multipleDocumentHandling)`	Указывает обработку нескольких копий, включая брошюровку, для заданий, использующих эти атрибуты.
`void`	`setMultipleDocumentHandlingToDefault()`	Устанавливает обработку нескольких копий, включая брошюровку, для заданий, использующих эти атрибуты, по умолчанию.
`void`	`setPageRanges(int[][] pageRanges)`	Указывает диапазоны страниц, которые нужно печатать, если нужно печатать диапазон страниц для заданий, использующих эти атрибуты.
`void`	`setPrinter(String printer)`	Указывает принтер назначения для заданий, использующих эти атрибуты.
`void`	`setSides(JobAttributes.SidesType sides)`	Указывает, как последовательные страницы должны быть наложены на стороны носителя печати для заданий, использующих эти атрибуты.
`void`	`setSidesToDefault()`	Устанавливает способ наложения последовательных страниц на стороны носителя печати для заданий, использующих эти атрибуты, по умолчанию.
`void`	`setToPage(int toPage)`	Указывает последнюю страницу (включительно) для печати, если нужно печатать диапазон страниц для заданий, использующих эти атрибуты.
`String`	`toString()`	Возвращает строковое представление этого JobAttributes.

Методы, объявленные в классе java.lang.Object

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

Подробное описание конструкторов

JobAttributes

public JobAttributes()

Создаёт экземпляр JobAttributes со значениями по умолчанию для каждого атрибута. Диалоговое окно по умолчанию DialogType.NATIVE. Минимальная страница по умолчанию 1. Максимальная страница по умолчанию Integer.MAX_VALUE. Пункт назначения по умолчанию DestinationType.PRINTER. Выбор по умолчанию DefaultSelectionType.ALL. Количество копий по умолчанию 1. Обработка нескольких документов по умолчанию MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES. Стороны по умолчанию SidesType.ONE_SIDED. Имя файла по умолчанию null.

JobAttributes

public JobAttributes(JobAttributes obj)

Создаёт экземпляр JobAttributes — копию переданного JobAttributes.

Параметры:: obj - копируемый JobAttributes

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)

Создаёт экземпляр JobAttributes со значениями указанных атрибутов.

Параметры:

copies - целое число больше 0

defaultSelection - DefaultSelectionType.ALL, DefaultSelectionType.RANGE, или DefaultSelectionType.SELECTION

destination - DestinationType.FILE или DestinationType.PRINTER

dialog - DialogType.COMMON, DialogType.NATIVE, или DialogType.NONE

fileName - возможно, имя файла

maxPage - целое число больше нуля и больше или равно minPage

minPage - целое число больше нуля и меньше или равно maxPage

multipleDocumentHandling - MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_COLLATED_COPIES или MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES

pageRanges - массив целых массивов из двух элементов; массив интерпретируется как диапазон, охватывающий все страницы, включая и между указанными страницами; диапазоны должны быть в порядке возрастания и не должны перекрываться; указанные номера страниц не могут быть меньше minPage и больше maxPage; например:

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

определяет страницы 1, 2, 3, 5, 15, 16, 17, 18 и 19. Обратите внимание, что (new int[][] { new int[] { 1, 1 }, new int[] { 1, 2 } }) — недопустимый набор диапазонов страниц, так как диапазоны перекрываются

printer - возможно, имя принтера

sides - SidesType.ONE_SIDED, SidesType.TWO_SIDED_LONG_EDGE, или SidesType.TWO_SIDED_SHORT_EDGE

Исключения:

IllegalArgumentException - если одно или несколько из вышеперечисленных условий нарушены

Подробное описание методов

clone

public Object clone()

Создаёт и возвращает копию данного JobAttributes.

Переопределяет:

clone в классе Object

Возвращает:

новую копию; безопасно привести этот объект к типу JobAttributes

См. также:

set

public void set(JobAttributes obj)

Устанавливает все атрибуты этого JobAttributes в соответствии со значениями атрибутов obj.

Параметры:: obj - копируемый JobAttributes

getCopies

public int getCopies()

Возвращает количество копий, которые приложение должно создать для задач, использующих эти атрибуты. Этот атрибут обновляется до значения, выбранного пользователем.

Возвращает:: целое число больше 0.

setCopies

public void setCopies(int copies)

Устанавливает количество копий, которые приложение должно создать для задач, использующих эти атрибуты. Отсутствие указания этого атрибута эквивалентно указанию 1.

Параметры:: copies - целое число больше 0
Исключения:: IllegalArgumentException - если copies меньше или равно 0

setCopiesToDefault

public void setCopiesToDefault()

Устанавливает количество копий, которые приложение должно создать для задач, использующих эти атрибуты, в значение по умолчанию. По умолчанию количество копий равно 1.

getDefaultSelection

public JobAttributes.DefaultSelectionType getDefaultSelection()

Определяет, должны ли для задач, использующих эти атрибуты, приложение печатать все страницы, диапазон, указанный в возвращаемом значении getPageRanges, или текущий выбор. Этот атрибут обновляется до значения, выбранного пользователем.

Возвращает:: DefaultSelectionType.ALL, DefaultSelectionType.RANGE или DefaultSelectionType.SELECTION

setDefaultSelection

public void setDefaultSelection(JobAttributes.DefaultSelectionType defaultSelection)

Определяет, должны ли для задач, использующих эти атрибуты, приложение печатать все страницы, диапазон, указанный в возвращаемом значении getPageRanges, или текущий выбор. Отсутствие указания этого атрибута эквивалентно указанию DefaultSelectionType.ALL.

Параметры:: defaultSelection - DefaultSelectionType.ALL, DefaultSelectionType.RANGE или DefaultSelectionType.SELECTION.
Исключения:: IllegalArgumentException - если defaultSelection — null

getDestination

public JobAttributes.DestinationType getDestination()

Указывает, будет ли выход осуществляться на принтер или в файл для задач, использующих эти атрибуты. Этот атрибут обновляется до значения, выбранного пользователем.

Возвращает:: DestinationType.FILE или DestinationType.PRINTER

setDestination

public void setDestination(JobAttributes.DestinationType destination)

Указывает, будет ли выход осуществляться на принтер или в файл для задач, использующих эти атрибуты. Отсутствие указания этого атрибута эквивалентно указанию DestinationType.PRINTER.

Параметры:: destination - DestinationType.FILE или DestinationType.PRINTER.
Исключения:: IllegalArgumentException - если destination равно null.

getDialog

public JobAttributes.DialogType getDialog()

Возвращает, отображается ли для задач, использующих эти атрибуты, диалоговое окно печати, в котором можно изменить параметры печати, и какой тип диалогового окна отображать. DialogType.COMMON обозначает кроссплатформенное диалоговое окно печати на чистом Java. DialogType.NATIVE обозначает собственное диалоговое окно печати платформы. Если платформа не поддерживает собственное диалоговое окно печати, отображается чисто Java диалоговое окно. DialogType.NONE указывает отсутствие диалогового окна печати (т. е. фоновая печать). Этот атрибут не может быть изменён и не подлежит ограничениям реализации или целевого принтера.

Возвращает:: DialogType.COMMON, DialogType.NATIVE, или DialogType.NONE

setDialog

public void setDialog(JobAttributes.DialogType dialog)

Указывает, отображается ли для задач, использующих эти атрибуты, диалоговое окно печати, в котором можно изменить параметры печати, и какой тип диалогового окна отображать. DialogType.COMMON обозначает кроссплатформенное диалоговое окно печати на чистом Java. DialogType.NATIVE обозначает собственное диалоговое окно печати платформы. Если платформа не поддерживает собственное диалоговое окно печати, отображается чисто Java диалоговое окно. DialogType.NONE указывает отсутствие диалогового окна печати (т. е. фоновая печать). Отсутствие указания этого атрибута эквивалентно указанию DialogType.NATIVE.

Параметры:: dialog - DialogType.COMMON, DialogType.NATIVE или DialogType.NONE.
Исключения:: IllegalArgumentException - если dialog равно null.

getFileName

public String getFileName()

Указывает имя файла для выходного файла для задач, использующих эти атрибуты. Этот атрибут обновляется до значения, выбранного пользователем.

Возвращает:: возможное имя файла

setFileName

public void setFileName(String fileName)

Указывает имя файла для выходного файла для задач, использующих эти атрибуты. Значение по умолчанию зависит от платформы и реализации.

Параметры:: fileName - возможное имя файла (может быть null).

getFromPage

public int getFromPage()

Возвращает первую страницу для печати для задач, использующих эти атрибуты, если необходимо печатать диапазон страниц. Этот атрибут обновляется до значения, выбранного пользователем. Приложение должно игнорировать этот атрибут на выходе, если возвращаемое значение метода getDefaultSelection — DefaultSelectionType.RANGE. Приложение должно учитывать значение, возвращаемое методом getPageRanges, в приоритете над значением, возвращаемым этим методом, если это возможно.

Возвращает:: целое число больше нуля, меньше или равно toPage, больше или равно minPage и меньше или равно maxPage.

setFromPage

public void setFromPage(int fromPage)

Устанавливает для заданий, использующих эти атрибуты, первую страницу для печати, если требуется печать диапазона страниц. Если этот атрибут не указан, используются значения из атрибута pageRanges. Если заданы pageRanges и хотя бы один из атрибутов fromPage или toPage, pageRanges имеет приоритет. Отсутствие значений pageRanges, fromPage или toPage эквивалентно вызову setPageRanges(new int[][] { new int[] { minPage } });

Parameters:: fromPage - целое число больше нуля и меньше или равно toPage, больше или равно minPage и меньше или равно maxPage.
Throws:: IllegalArgumentException - если одно или несколько из вышеперечисленных условий нарушены.

getMaxPage

public int getMaxPage()

Устанавливает максимальное значение, которое пользователь может указать в качестве последней страницы для печати для заданий, использующих эти атрибуты. Этот атрибут не может быть изменён реализацией и не ограничен целевым принтером.

Returns:: целое число больше нуля и больше или равно minPage.

setMaxPage

public void setMaxPage(int maxPage)

Устанавливает максимальное значение, которое пользователь может указать в качестве последней страницы для печати для заданий, использующих эти атрибуты. Отсутствие этого атрибута эквивалентно указанию Integer.MAX_VALUE.

Parameters:: maxPage - целое число больше нуля и больше или равно minPage
Throws:: IllegalArgumentException - если одно или несколько из вышеперечисленных условий нарушены

getMinPage

public int getMinPage()

Устанавливает минимальное значение, которое пользователь может указать в качестве первой страницы для печати для заданий, использующих эти атрибуты. Этот атрибут не может быть изменён реализацией и не ограничен целевым принтером.

Returns:: целое число больше нуля и меньше или равно maxPage.

setMinPage

public void setMinPage(int minPage)

Устанавливает минимальное значение, которое пользователь может указать в качестве первой страницы для печати для заданий, использующих эти атрибуты. Отсутствие этого атрибута эквивалентно указанию 1.

Parameters:: minPage - целое число больше нуля и меньше или равно maxPage.
Throws:: IllegalArgumentException - если одно или несколько из вышеперечисленных условий нарушены.

getMultipleDocumentHandling

public JobAttributes.MultipleDocumentHandlingType getMultipleDocumentHandling()

Указывает способ обработки нескольких копий, включая брошюровку, для заданий, использующих эти атрибуты. Этот атрибут обновляется до значения, выбранного пользователем.

Returns:: MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_COLLATED_COPIES или MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES.

setMultipleDocumentHandling

public void setMultipleDocumentHandling(JobAttributes.MultipleDocumentHandlingType multipleDocumentHandling)

Указывает способ обработки нескольких копий, включая брошюровку, для заданий, использующих эти атрибуты. Отсутствие этого атрибута эквивалентно указанию MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES.

Parameters:: multipleDocumentHandling - MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_COLLATED_COPIES или MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES.
Throws:: IllegalArgumentException - если multipleDocumentHandling равно null.

setMultipleDocumentHandlingToDefault

public void setMultipleDocumentHandlingToDefault()

Устанавливает обработку нескольких копий, включая брошюровку, для заданий, использующих эти атрибуты, по умолчанию. Обработка по умолчанию — MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES.

getPageRanges

public int[][] getPageRanges()

Указывает для заданий, использующих эти атрибуты, диапазоны страниц для печати, если требуется печать диапазона страниц. Все номера диапазонов включительно. Этот атрибут обновляется до значения, выбранного пользователем. Приложение должно игнорировать этот атрибут на выходе, если возвращаемое значение метода getDefaultSelection — DefaultSelectionType.RANGE.

Returns:: массив целочисленных массивов по 2 элемента. Массив интерпретируется как диапазон, охватывающий все страницы, включая и между указанными страницами. Диапазоны должны быть в порядке возрастания и не должны перекрываться. Указанные номера страниц не могут быть меньше minPage или больше maxPage. Например: (new int[][] { new int[] { 1, 3 }, new int[] { 5, 5 }, new int[] { 15, 19 } }), задаёт страницы 1, 2, 3, 5, 15, 16, 17, 18 и 19.

setPageRanges

public void setPageRanges(int[][] pageRanges)

Указывает для заданий, использующих эти атрибуты, диапазоны страниц для печати, если требуется печать диапазона страниц. Все номера диапазонов включительно. Если этот атрибут не указан, используются значения из атрибутов fromPage и toPages. Если заданы pageRanges и хотя бы один из атрибутов fromPage или toPage, pageRanges имеет приоритет. Отсутствие значений pageRanges, fromPage или toPage эквивалентно вызову setPageRanges(new int[][] { new int[] { minPage, minPage } });

Parameters:: pageRanges - массив целочисленных массивов по 2 элемента. Массив интерпретируется как диапазон, охватывающий все страницы, включая и между указанными страницами. Диапазоны должны быть в порядке возрастания и не должны перекрываться. Указанные номера страниц не могут быть меньше minPage или больше maxPage. Например: (new int[][] { new int[] { 1, 3 }, new int[] { 5, 5 }, new int[] { 15, 19 } }), задаёт страницы 1, 2, 3, 5, 15, 16, 17, 18 и 19. Обратите внимание, что (new int[][] { new int[] { 1, 1 }, new int[] { 1, 2 } }), - недопустимый набор диапазонов страниц, так как диапазоны перекрываются.
Throws:: IllegalArgumentException - если одно или несколько из вышеперечисленных условий нарушены.

getPrinter

public String getPrinter()

Возвращает целевой принтер для заданий, использующих эти атрибуты. Этот атрибут обновляется до значения, выбранного пользователем.

Returns:: возможно null имя принтера.

setPrinter

public void setPrinter(String printer)

Указывает целевой принтер для заданий, использующих эти атрибуты. По умолчанию зависит от платформы и реализации.

Parameters:: printer - возможно null имя принтера.

getSides

public JobAttributes.SidesType getSides()

Возвращает способ размещения последовательных страниц на сторонах носителя печати для заданий, использующих эти атрибуты. SidesType.ONE_SIDED размещает каждую последовательную страницу на одной стороне последовательных листов бумаги. Такое расположение иногда называется *простым*. SidesType.TWO_SIDED_LONG_EDGE размещает каждую последовательную пару страниц на лицевой и обратной сторонах последовательных листов бумаги, так что ориентация каждой пары страниц на носителе была бы правильной для читателя, как если бы она была связана по длинному краю. Такое расположение иногда называется *дуплексом*. SidesType.TWO_SIDED_SHORT_EDGE размещает каждую последовательную пару страниц на лицевой и обратной сторонах последовательных листов бумаги, так что ориентация каждой пары страниц на носителе была бы правильной для читателя, как если бы она была связана по короткому краю. Такое расположение иногда называется *разворотом*. Этот атрибут обновляется до значения, выбранного пользователем.

Returns:: SidesType.ONE_SIDED, SidesType.TWO_SIDED_LONG_EDGE или SidesType.TWO_SIDED_SHORT_EDGE.

setSides

public void setSides(JobAttributes.SidesType sides)

Указывает способ размещения последовательных страниц на сторонах носителя печати для заданий, использующих эти атрибуты. SidesType.ONE_SIDED размещает каждую последовательную страницу на одной стороне последовательных листов бумаги. Такое расположение иногда называется *простым*. SidesType.TWO_SIDED_LONG_EDGE размещает каждую последовательную пару страниц на лицевой и обратной сторонах последовательных листов бумаги, так что ориентация каждой пары страниц на носителе была бы правильной для читателя, как если бы она была связана по длинному краю. Такое расположение иногда называется *дуплексом*. SidesType.TWO_SIDED_SHORT_EDGE размещает каждую последовательную пару страниц на лицевой и обратной сторонах последовательных листов бумаги, так что ориентация каждой пары страниц на носителе была бы правильной для читателя, как если бы она была связана по короткому краю. Такое расположение иногда называется *разворотом*. Отсутствие этого атрибута эквивалентно указанию SidesType.ONE_SIDED.

Parameters:: sides - SidesType.ONE_SIDED, SidesType.TWO_SIDED_LONG_EDGE или SidesType.TWO_SIDED_SHORT_EDGE.
Throws:: IllegalArgumentException - если sides равно null.

setSidesToDefault

public void setSidesToDefault()

Устанавливает способ размещения последовательных страниц на сторонах носителя печати для заданий, использующих эти атрибуты, по умолчанию. Размещение по умолчанию — SidesType.ONE_SIDED.

getToPage

public int getToPage()

Возвращает для заданий, использующих эти атрибуты, последнюю страницу (включительно) для печати, если требуется печать диапазона страниц. Этот атрибут обновляется до значения, выбранного пользователем. Приложение должно игнорировать этот атрибут на выходе, если возвращаемое значение метода getDefaultSelection равно DefaultSelectionType.RANGE. Приложение должно отдавать предпочтение возвращаемому значению метода getPageRanges, если это возможно.

Returns:: целое число больше нуля и больше или равно toPage, больше или равно minPage и меньше или равно maxPage.

setToPage

public void setToPage(int toPage)

Указывает для задач, использующих эти атрибуты, последнюю страницу (включительно), которая должна быть напечатана, если необходимо распечатать диапазон страниц. Если этот атрибут не указан, используются значения из атрибута pageRanges. Если указаны pageRanges и либо fromPage, либо toPage, или оба, pageRanges имеют приоритет. Отсутствие pageRanges, fromPage или toPage эквивалентно вызову setPageRanges(new int[][] { new int[] { minPage } });

Parameters:: toPage - целое число больше нуля и больше или равно fromPage и больше или равно minPage и меньше или равно maxPage.
Throws:: IllegalArgumentException - если одно или несколько из вышеперечисленных условий нарушены.

equals

public boolean equals(Object obj)

Определяет, равны ли два JobAttributes друг другу.

Два JobAttributes равны тогда и только тогда, когда равны каждый из их атрибутов. Атрибуты перечислимого типа равны, если и только если поля ссылаются на один и тот же уникальный объект перечисления. Набор диапазонов страниц равен, если и только если наборы имеют одинаковую длину, каждый диапазон перечисляет те же страницы и диапазоны расположены в том же порядке.

Overrides:

equals в классе Object

Parameters:

obj - объект, равенство которого будет проверено.

Returns:

равен ли obj этому JobAttribute в соответствии с вышеуказанными критериями.

See Also:

hashCode

public int hashCode()

Возвращает значение хэш-кода для этого JobAttributes.

Overrides:

hashCode в классе Object

Returns:

хэш-код.

See Also:

toString

public String toString()

Возвращает строковое представление этого JobAttributes.

Overrides:: toString в классе Object
Returns:: строковое представление.

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/java/awt/JobAttributes.html