Класс JobAttributes

Все реализованные интерфейсы:
Cloneable
public final class JobAttributes
extends Object
implements Cloneable

Набор атрибутов, которые управляют заданием печати.

Экземпляры этого класса контролируют количество копий, стандартный выбор, место назначения, диалог печати, имена файла и принтера, диапазоны страниц, обработку нескольких документов (включая брошюровку), и многостраничную импозицию (например, дуплекс) каждого задания печати, использующего экземпляр. Имена атрибутов соответствуют Протоколу печати в Интернете (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 class  JobAttributes.DefaultSelectionType

Безопасное для типов перечисление возможных состояний стандартного выбора.
static class  JobAttributes.DestinationType

Безопасное для типов перечисление возможных мест назначения заданий.
static class  JobAttributes.DialogType

Безопасное для типов перечисление возможных диалогов для отображения пользователю.
static class  JobAttributes.MultipleDocumentHandlingType

Безопасное для типов перечисление возможных состояний обработки нескольких копий.
static 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.

Overrides:
clone в классе Object
Возвращает:
новую созданную копию; безопасно привести этот объект к типу JobAttributes
См. также:
Cloneable

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

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

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

setFileName

public void setFileName(String fileName)

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

Параметры:
fileName - возможно нулевое имя файла.

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 } });

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

getMaxPage

public int getMaxPage()

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

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

setMaxPage

public void setMaxPage(int maxPage)

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

Параметры:
maxPage - целое число, большее нуля и большее или равное minPage
Исключения:
IllegalArgumentException - если одно или несколько из вышеперечисленных условий нарушены

getMinPage

public int getMinPage()

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

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

setMinPage

public void setMinPage(int minPage)

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

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

getMultipleDocumentHandling

public JobAttributes.MultipleDocumentHandlingType getMultipleDocumentHandling()

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

Возвращает:
MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_COLLATED_COPIES или MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES.

setMultipleDocumentHandling

public void setMultipleDocumentHandling(JobAttributes.MultipleDocumentHandlingType multipleDocumentHandling)

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

Параметры:
multipleDocumentHandling - MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_COLLATED_COPIES или MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES.
Исключения:
IllegalArgumentException - если multipleDocumentHandling равно null.

setMultipleDocumentHandlingToDefault

public void setMultipleDocumentHandlingToDefault()

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

getPageRanges

public int[][] getPageRanges()

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

Возвращает:
массив массивов целых чисел из 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 и toPage. Если указаны pageRanges и хотя бы один из fromPage или toPage, pageRanges имеет приоритет. Отсутствие pageRanges, fromPage или toPage эквивалентно вызову setPageRanges(new int[][] { new int[] { minPage, minPage } });

Параметры:
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 } }), является недопустимым набором диапазонов страниц, так как два диапазона перекрываются.
Исключения:
IllegalArgumentException - если одно или несколько из вышеперечисленных условий нарушены.

getPrinter

public String getPrinter()

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

Возвращает:
возможно пустое имя принтера.

setPrinter

public void setPrinter(String printer)

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

Параметры:
printer - возможно пустое имя принтера.

getSides

public JobAttributes.SidesType getSides()

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

Возвращает:
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.

Параметры:
sides - SidesType.ONE_SIDED, SidesType.TWO_SIDED_LONG_EDGE или SidesType.TWO_SIDED_SHORT_EDGE.
Исключения:
IllegalArgumentException - если sides равно null.

setSidesToDefault

public void setSidesToDefault()

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

getToPage

public int getToPage()

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

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

setToPage

public void setToPage(int toPage)

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

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

equals

public boolean equals(Object obj)

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

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

Переопределяет:
equals в классе Object
Параметры:
obj - объект, равенство которого будет проверяться.
Возвращает:
является ли obj равным этому JobAttribute в соответствии с вышеуказанными критериями.
См. также:
Object.hashCode(), HashMap

hashCode

public int hashCode()

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

Переопределяет:
hashCode в классе Object
Возвращает:
код хэширования.
См. также:
Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

toString

public String toString()

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

Переопределяет:
toString в классе Object
Возвращает:
строковое представление.

© 1993, 2020, 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/11/docs/api/java.desktop/java/awt/JobAttributes.html

Spec-Zone .ru
спецификации, руководства, описания, API