Spec-Zone.ru › OpenJDK 25

Класс 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.

Методы, объявленные в классе 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 — возможно, 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
Возвращает:
только что созданную копию; этот объект можно безопасно привести к типу 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, 2025, 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/JobAttributes.html

Spec-Zone.ru

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