Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class JobAttributes extends Object implements Cloneable
Экземпляры этого class управляют числом копий, выбора значения по умолчанию, места назначения, печатают диалоговое окно, файл и имена принтера, диапазоны страницы, многократная обработка документов (включая сопоставление), и многостраничное наложение (такие как дуплекс) каждого задания печати, которое использует экземпляр. Названия атрибута совместимы с интернет-Протоколом Печати (IPP) 1.1 где только возможно. Значения атрибута частично совместимы где только возможно.
Чтобы использовать метод, который берет внутренний тип class, передайте ссылку на одно из постоянных полей внутреннего class. Клиентский код не может создать новые экземпляры внутренних типов class, потому что ни у одного из тех классов нет общедоступного конструктора. Например, чтобы установить диалоговый тип печати в межплатформенный, чистый Java печатают диалоговое окно, используют следующий код:
import java.awt.JobAttributes; public class PureJavaPrintDialogExample { public void setPureJavaPrintDialog(JobAttributes jobAttributes) { jobAttributes.setDialog(JobAttributes.DialogType.COMMON); } }
У каждого атрибута IPP, который поддерживает attributeName-значение-по-умолчанию, есть соответствие setattributeNameToDefault
метод. Поля значения по умолчанию не обеспечиваются.
Модификатор и Тип | Класс и Описание |
---|---|
static class |
JobAttributes. DefaultSelectionType
Безопасное с точки зрения типов перечисление возможных состояний выбора значения по умолчанию.
|
static class |
JobAttributes. DestinationType
Безопасное с точки зрения типов перечисление возможных мест назначения задания.
|
static class |
JobAttributes. DialogType
Безопасное с точки зрения типов перечисление возможных диалоговых окон, чтобы вывести на экран пользователю.
|
static class |
JobAttributes.MultipleDocumentHandlingType
Безопасное с точки зрения типов перечисление возможных многократных состояний обработки копии.
|
static class |
JobAttributes. SidesType
Безопасное с точки зрения типов перечисление возможных многостраничных наложений.
|
Конструктор и Описание |
---|
JobAttributes()
Конструкции a
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)
Конструкции a
JobAttributes экземпляр с указанными значениями для каждого атрибута. |
JobAttributes(JobAttributes obj)
Конструкции a
JobAttributes экземпляр, который является копией предоставленного JobAttributes . |
Модификатор и Тип | Метод и Описание |
---|---|
Объект |
clone()
Создает и возвращает копию этого
JobAttributes . |
boolean |
equals(Object obj)
Определяет, равны ли два JobAttributes друг другу.
|
int |
getCopies()
Возвращает число копий, которые приложение должно представить для заданий, используя эти атрибуты.
|
JobAttributes. DefaultSelectionType |
getDefaultSelection()
Определяет, должно ли, для заданий, используя эти атрибуты, приложение напечатать все страницы, диапазон, определенный возвращаемым значением
getPageRanges , или текущий выбор. |
JobAttributes. DestinationType |
getDestination()
Определяет, будет ли выведенный к принтеру или файлу для заданий, используя эти атрибуты.
|
JobAttributes. DialogType |
getDialog()
Возвраты, ли, для заданий, используя эти атрибуты, пользователь должен видеть диалоговое окно печати, в котором можно изменить настройки печати, и какой тип диалогового окна печати должен быть выведен на экран.
|
Строка |
getFileName()
Определяет имя файла для выходного файла для заданий, используя эти атрибуты.
|
int |
getFromPage()
Возвраты, для заданий, используя эти атрибуты, первая страница, которая будет напечатана, если диапазон страниц должен быть напечатан.
|
int |
getMaxPage()
Определяет значение максимума, которое пользователь может определить как последнюю страницу, которая будет напечатана для заданий, используя эти атрибуты.
|
int |
getMinPage()
Определяет значение минимума, которое пользователь может определить как первую страницу, которая будет напечатана для заданий, используя эти атрибуты.
|
JobAttributes.MultipleDocumentHandlingType |
getMultipleDocumentHandling()
Определяет обработку многократных копий, включая сопоставление, для заданий, используя эти атрибуты.
|
int[][] |
getPageRanges()
Определяет, для заданий, используя эти атрибуты, диапазоны страниц, которые будут напечатаны, если диапазон страниц должен быть напечатан.
|
Строка |
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)
Определяет, для заданий, используя эти атрибуты, последняя страница (включительно), чтобы быть напечатанным, если диапазон страниц должен быть напечатан.
|
Строка |
toString()
Возвращает строковое представление этого JobAttributes.
|
public JobAttributes()
JobAttributes
экземпляр со значениями по умолчанию для каждого атрибута. Диалоговые значения по умолчанию к DialogType.NATIVE
. Минимальные значения по умолчанию страницы к 1
. Максимальные значения по умолчанию страницы к Integer.MAX_VALUE
. Целевые значения по умолчанию к DestinationType.PRINTER
. Значения по умолчанию выбора к DefaultSelectionType.ALL
. Число значений по умолчанию копий к 1
. Многократные значения по умолчанию обработки документов к MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES
. Значения по умолчанию сторон к SidesType.ONE_SIDED
. Значения по умолчанию имени файла к null
.public JobAttributes(JobAttributes obj)
JobAttributes
экземпляр, который является копией предоставленного JobAttributes
.obj
- 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
- целое число, больше чем 0defaultSelection
- DefaultSelectionType.ALL
, DefaultSelectionType.RANGE
, или DefaultSelectionType.SELECTION
destination
- DesintationType.FILE
или DesintationType.PRINTER
dialog
- DialogType.COMMON
, DialogType.NATIVE
, или DialogType.NONE
fileName
- возможно null
имя файлаmaxPage
- целое число, больше чем нуль и больше чем или равный minPageminPage
- целое число, больше чем нуль и меньше чем или равный maxPagemultipleDocumentHandling
- 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
- если один или больше вышеупомянутых условий нарушаетсяpublic Object clone()
JobAttributes
.public void set(JobAttributes obj)
JobAttributes
к тем же самым значениям как атрибуты obj.obj
- JobAttributes
скопироватьpublic int getCopies()
public void setCopies(int copies)
1
.copies
- целое число, больше чем 0IllegalArgumentException
- если copies
меньше чем или равно 0public void setCopiesToDefault()
public JobAttributes.DefaultSelectionType getDefaultSelection()
getPageRanges
, или текущий выбор. Этот атрибут обновляется к значению, выбранному пользователем.public void setDefaultSelection(JobAttributes.DefaultSelectionType defaultSelection)
getPageRanges
, или текущий выбор. Не определение этого атрибута эквивалентно определению DefaultSelectionType. ВСЕ.defaultSelection
- DefaultSelectionType. ВСЕ, DefaultSelectionType. ДИАПАЗОН, или DefaultSelectionType. ВЫБОР.IllegalArgumentException
- если defaultSelection null
public JobAttributes.DestinationType getDestination()
public void setDestination(JobAttributes.DestinationType destination)
destination
- DesintationType. ФАЙЛ или DesintationType. ПРИНТЕР.IllegalArgumentException
- если место назначения является нулем.public JobAttributes.DialogType getDialog()
DialogType.COMMON
, DialogType.NATIVE
, или DialogType.NONE
public void setDialog(JobAttributes.DialogType dialog)
dialog
- DialogType. РАСПРОСТРАНЕННЫЙ, DialogType. СОБСТВЕННЫЙ, или DialogType. НИ ОДИН.IllegalArgumentException
- если диалоговое окно является нулем.public String getFileName()
null
имя файлаpublic void setFileName(String fileName)
fileName
- возможно нулевое имя файла.public int getFromPage()
getDefaultSelection
методом является DefaultSelectionType. ДИАПАЗОН. Приложение должно соблюдать возвращаемое значение getPageRanges
по возвращаемому значению этого метода, если возможный.public void setFromPage(int fromPage)
fromPage
- целое число, больше чем нуль и меньше чем или равный toPage и больше чем или равный minPage и меньше чем или равный maxPage.IllegalArgumentException
- если один или больше вышеупомянутых условий нарушается.public int getMaxPage()
public void setMaxPage(int maxPage)
Integer.MAX_VALUE
.maxPage
- целое число, больше чем нуль и больше чем или равный minPageIllegalArgumentException
- если один или больше вышеупомянутых условий нарушаетсяpublic int getMinPage()
public void setMinPage(int minPage)
1
.minPage
- целое число, больше чем нуль и меньше чем или равный maxPage.IllegalArgumentException
- если один или больше вышеупомянутых условий нарушается.public JobAttributes.MultipleDocumentHandlingType getMultipleDocumentHandling()
public void setMultipleDocumentHandling(JobAttributes.MultipleDocumentHandlingType multipleDocumentHandling)
multipleDocumentHandling
- MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_COLLATED_COPIES или MultipleDocumentHandlingType.SEPARATE_DOCUMENTS_UNCOLLATED_COPIES.IllegalArgumentException
- если multipleDocumentHandling является нулем.public void setMultipleDocumentHandlingToDefault()
public int[][] getPageRanges()
getDefaultSelection
методом является DefaultSelectionType. ДИАПАЗОН.public void setPageRanges(int[][] pageRanges)
pageRanges
- массив целочисленных массивов 2 элементов. Массив интерпретируется как диапазон, охватывающий все страницы включая и между указанными страницами. Диапазоны должны быть в порядке возрастания и не должны наложиться. Указанные номера страниц не могут быть меньше чем minPage, ни больше чем maxPage. Например: (новый интервал [] [] {новый интервал [] {1, 3}, новый интервал [] {5, 5}, новый интервал [] {15, 19}}), определяет страницы 1, 2, 3, 5, 15, 16, 17, 18, и 19. Отметьте, что (новый интервал [] [] {новый интервал [] {1, 1}, новый интервал [] {1, 2}}), недопустимый набор диапазонов страницы, потому что два диапазона накладываются.IllegalArgumentException
- если один или больше вышеупомянутых условий нарушается.public String getPrinter()
public void setPrinter(String printer)
printer
- возможно нулевое имя принтера.public JobAttributes.SidesType getSides()
public void setSides(JobAttributes.SidesType sides)
sides
- SidesType. ONE_SIDED, SidesType. TWO_SIDED_LONG_EDGE, или SidesType. TWO_SIDED_SHORT_EDGE.IllegalArgumentException
- если стороны являются нулем.public void setSidesToDefault()
public int getToPage()
getDefaultSelection
методом является DefaultSelectionType. ДИАПАЗОН. Приложение должно соблюдать возвращаемое значение getPageRanges
по возвращаемому значению этого метода, если возможный.public void setToPage(int toPage)
toPage
- целое число, больше чем нуль и больше чем или равный fromPage и больше чем или равный minPage и меньше чем или равный maxPage.IllegalArgumentException
- если один или больше вышеупомянутых условий нарушается.public boolean equals(Object obj)
Два JobAttributes равны, если и только если каждый из их атрибутов равен. Атрибуты типа перечисления равны, если и только если поля обращаются к тому же самому уникальному объекту перечисления. Ряд диапазонов страницы равен, если и только если наборы имеют равную длину, каждый диапазон перечисляет те же самые страницы, и диапазоны находятся в том же самом порядке.
equals
в class Object
obj
- объект, равенство которого будет проверено.Object.hashCode()
, HashMap
public int hashCode()
hashCode
в class Object
Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92