Spec-Zone.ru › OpenJDK 27

Класс 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-default, имеется соответствующий метод 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.

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

finalize, getClass, notify, notifyAll, wait, wait, wait
Модификатор и тип Метод Описание
protected void finalize()
Устарело, будет удалено: этот элемент API может быть удален в будущей версии.
Финализация устарела и будет удалена в одном из будущих выпусков.
final Class<?> getClass()
Возвращает класс времени выполнения этого Object.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
final void wait()
Переводит текущий поток в состояние ожидания до его пробуждения, обычно посредством вызова notify или прерывания.
final void wait(long timeoutMillis)
Переводит текущий поток в состояние ожидания до его пробуждения, обычно посредством вызова notify или прерывания, либо до истечения заданного промежутка реального времени.
final void wait(long timeoutMillis, int nanos)
Переводит текущий поток в состояние ожидания до его пробуждения, обычно посредством вызова notify или прерывания, либо до истечения заданного промежутка реального времени.

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

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 — возможно, null имя файла
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 — возможно, null имя принтера
sides — SidesType.ONE_SIDED, SidesType.TWO_SIDED_LONG_EDGE или SidesType.TWO_SIDED_SHORT_EDGE
Исключения:
IllegalArgumentException — если нарушено одно или несколько перечисленных выше условий

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

clone

public Object clone()
Создает и возвращает копию этого JobAttributes.
Переопределяет:
clone в классе Object
Возвращает:
вновь созданную копию; этот объект 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 — возможно, 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 } });
Параметры:
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 и toPages. Если указаны 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()
Возвращает принтер назначения для заданий с этими атрибутами. Этот атрибут обновляется до значения, выбранного пользователем.
Возвращает:
возможно, null-имя принтера.

setPrinter

public void setPrinter(String printer)
Указывает принтер назначения для заданий с этими атрибутами. Значение по умолчанию зависит от платформы и определяется реализацией.
Параметры:
printer — возможно, null-имя принтера.

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

toString

public String toString()
Возвращает строковое представление этого объекта JobAttributes.
Переопределяет:
toString в классе Object
Возвращает:
строковое представление.

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2026, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API