PrinterJob (Платформа Java SE 7)

java.lang. Объект
- java.awt.print. PrinterJob

```
public abstract class PrinterJob
extends Object
```
PrinterJob класс является основным классом, который управляет печатью. Приложение вызывает методы в этом классе, чтобы установить задание, дополнительно вызвать диалоговое окно печати с пользователем, и затем напечатать страницы задания.

Сводка конструктора

Конструкторы
Конструктор и Описание
`PrinterJob()` A `PrinterJob` объект должен быть создан, используя помехи `getPrinterJob` метод.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`abstract void`	`cancel()` Отменяет задание печати, которое происходит.
`PageFormat`	`defaultPage()` Создает новое `PageFormat` экземпляр и наборы это к размеру по умолчанию и ориентации.
`abstract PageFormat`	`defaultPage(PageFormat page)` Клоны `PageFormat` параметр и изменяет клона, чтобы описать размер страницы по умолчанию и ориентацию.
`abstract int`	`getCopies()` Заставляет число копий быть напечатанным.
`abstract String`	`getJobName()` Заставляет имя документа быть напечатанным.
`PageFormat`	`getPageFormat(PrintRequestAttributeSet attributes)` Вычисляет a `PageFormat` со значениями, непротиворечивыми с поддерживаемыми током `PrintService` для этого задания (то есть значение, возвращенное `getPrintService()`) и носители, печатаемая область и ориентация, содержавшаяся в `attributes`.
`static PrinterJob`	`getPrinterJob()` Создает и возвращает a `PrinterJob` который первоначально связывается с принтером по умолчанию.
`PrintService`	`getPrintService()` Возвращает службу (принтер) для этого задания принтера.
`abstract String`	`getUserName()` Получает имя пользователя печати.
`abstract boolean`	`isCancelled()` Возвраты `true` если задание печати происходит, но собирается быть отмененным в следующей возможности; иначе возвраты `false`.
`static PrintService[]`	`lookupPrintServices()` Метод удобства, который ищет 2-D службы печати.
`static StreamPrintServiceFactory[]`	`lookupStreamPrintServices(String mimeType)` Метод удобства, который определяет местоположение фабрик для потоковых служб печати, которые могут отобразить 2-D графику.
`abstract PageFormat`	`pageDialog(PageFormat page)` Выводит на экран диалоговое окно, которое позволяет модификацию a `PageFormat` экземпляр.
`PageFormat`	`pageDialog(PrintRequestAttributeSet attributes)` Метод удобства, который выводит на экран межплатформенную страницу, устанавливает диалоговое окно.
`abstract void`	`print()` Печатные издания ряд страниц.
`void`	`print(PrintRequestAttributeSet attributes)` Печатные издания ряд страниц, используя настройки в атрибуте устанавливаются.
`abstract boolean`	`printDialog()` Представляет диалоговое окно пользователю для того, чтобы изменить свойства задания печати.
`boolean`	`printDialog(PrintRequestAttributeSet attributes)` Метод удобства, который выводит на экран межплатформенное диалоговое окно печати для всех служб, которые способны к печати 2-D графики, используя `Pageable` интерфейс.
`abstract void`	`setCopies(int copies)` Определяет номер копий, которые будут напечатаны.
`abstract void`	`setJobName(String jobName)` Определяет имя документа, который будет напечатан.
`abstract void`	`setPageable(Pageable document)` Запросы `document` для числа страниц и `PageFormat` и `Printable` для каждой страницы, сдержанной `Pageable` экземпляр, `document`.
`abstract void`	`setPrintable(Printable painter)` Вызовы `painter` представлять страницы.
`abstract void`	`setPrintable(Printable painter, PageFormat format)` Вызовы `painter` представлять страницы в указанном `format`.
`void`	`setPrintService(PrintService service)` Свяжите этот PrinterJob с новым PrintService.
`abstract PageFormat`	`validatePage(PageFormat page)` Возвращает клона `page` с его настройками, скорректированными, чтобы быть совместимым с текущим принтером этого `PrinterJob`.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь конструктора
  - PrinterJob
```
public PrinterJob()
```
    A PrinterJob объект должен быть создан, используя помехи getPrinterJob метод.
- Деталь метода
  - getPrinterJob
```
public static PrinterJob getPrinterJob()
```
    Создает и возвращает a PrinterJob который первоначально связывается с принтером по умолчанию. Если никакие принтеры не будут доступны на системе, то PrinterJob будет все еще возвращен из этого метода, но getPrintService() возвратится null, и вызов print с этим PrinterJob мог бы генерировать исключение. Приложения, которые должны определить, есть ли подходящие принтеры прежде, чем создать a PrinterJob должен гарантировать что массив, возвращенный из lookupPrintServices не пусто.
    
    Возвраты:
    новое PrinterJob.
    
    Броски:
    
    SecurityException - если менеджер безопасности существует и SecurityManager.checkPrintJobAccess() метод отвергает этот поток от создания запроса задания печати
  - lookupPrintServices
```
public static PrintService[] lookupPrintServices()
```
    Метод удобства, который ищет 2-D службы печати. Службы, возвращенные из этого метода, могут быть установлены на PrinterJobs, которые поддерживают службы печати. Вызов этого метода эквивалентен вызову PrintServiceLookup.lookupPrintServices() и определяя Листаемый DocFlavor.
    
    Возвраты:
    возможно пустой массив 2-D служб печати.
    С тех пор:
    
    1.4
  - lookupStreamPrintServices
```
public static StreamPrintServiceFactory[] lookupStreamPrintServices(String mimeType)
```
    Метод удобства, который определяет местоположение фабрик для потоковых служб печати, которые могут отобразить 2-D графику. Демонстрационное использование:
```
 FileOutputStream outstream;
 StreamPrintService psPrinter;
 String psMimeType = "application/postscript";
 PrinterJob pj = PrinterJob.getPrinterJob();

 StreamPrintServiceFactory[] factories =
     PrinterJob.lookupStreamPrintServices(psMimeType);
 if (factories.length > 0) {
     try {
         outstream = new File("out.ps");
         psPrinter =  factories[0].getPrintService(outstream);
         // psPrinter can now be set as the service on a PrinterJob
         pj.setPrintService(psPrinter)
     } catch (Exception e) {
         e.printStackTrace();
     }
 }
 
```
    Службы, возвращенные из этого метода, могут быть установлены на PrinterJob экземпляры, которые поддерживают службы печати. Вызов этого метода эквивалентен вызову StreamPrintServiceFactory.lookupStreamPrintServiceFactories() и определяя Листаемый DocFlavor.
    Параметры:
    mimeType - необходимый выходной формат, или нуль, чтобы означать любой формат.
    
    Возвраты:
    возможно пустой массив 2-D потоковых фабрик службы печати.
    С тех пор:
    
    1.4
  - getPrintService
```
public PrintService getPrintService()
```
    Возвращает службу (принтер) для этого задания принтера. Реализации этого класса, которые не поддерживают службы печати, могут возвратить нуль. нуль будет также возвращен, если никакие принтеры не будут доступны.
    
    Возвраты:
    служба для этого задания принтера.
    С тех пор:
    
    1.4
    
    См. Также:
    setPrintService(PrintService), getPrinterJob()
  - setPrintService
```
public void setPrintService(PrintService service)
                     throws PrinterException
```
    Свяжите этот PrinterJob с новым PrintService. Этот метод переопределяется подклассами, которые поддерживают определение Службы печати. Броски PrinterException если указанная служба не может поддерживать Pageable и Printable взаимодействует через интерфейс необходимый, чтобы поддерживать 2-D печать.
    
    Параметры:
    service - служба печати, которая поддерживает 2-D печать
    
    Броски:
    
    PrinterException - если указанная служба не поддерживает 2-D печать, или этот класс PrinterJob не поддерживает установку 2-D службы печати, или указанная служба является иначе не допустимой службой печати.
    С тех пор:
    
    1.4
    
    См. Также:
    getPrintService()
  - setPrintable
```
public abstract void setPrintable(Printable painter)
```
    Вызовы painter представлять страницы. Страницы в документе, который будет напечатан этим PrinterJob представляются Printable объект, painter. PageFormat поскольку каждая страница является форматом страницы по умолчанию.
    
    Параметры:
    painter - Printable это представляет каждую страницу документа.
  - setPrintable
```
public abstract void setPrintable(Printable painter,
                PageFormat format)
```
    Вызовы painter представлять страницы в указанном format. Страницы в документе, который будет напечатан этим PrinterJob представляются Printable объект, painter. PageFormat из каждой страницы format.
    
    Параметры:
    painter - Printable вызванный, чтобы представить каждую страницу документа
    format - размер и ориентация каждой страницы, которая будет напечатана
  - setPageable
```
public abstract void setPageable(Pageable document)
                          throws NullPointerException
```
    Запросы document для числа страниц и PageFormat и Printable для каждой страницы, сдержанной Pageable экземпляр, document.
    
    Параметры:
    document - страницы, которые будут напечатаны. Это не может быть null.
    
    Броски:
    
    NullPointerException - Pageable переданный в был null.
    См. Также:
    PageFormat, Printable
  - printDialog
```
public abstract boolean printDialog()
                             throws HeadlessException
```
    Представляет диалоговое окно пользователю для того, чтобы изменить свойства задания печати. Этот метод выведет на экран собственное диалоговое окно, если собственная служба печати будет выбрана, и пользовательский выбор принтеров будет ограничен этим собственным службам печати. Чтобы представить перекрестную платформу печатают диалоговое окно для всех служб, включая собственные вместо этого используют printDialog(PrintRequestAttributeSet).
    Реализации PrinterJob, которые могут использовать PrintService, обновят PrintService для этого PrinterJob, чтобы отразить новую службу, выбранную пользователем.
    
    Возвраты:
    true если пользователь не отменяет диалоговое окно; false иначе.
    
    Броски:
    
    HeadlessException - если GraphicsEnvironment.isHeadless () возвращает true.
    См. Также:
    GraphicsEnvironment.isHeadless()
  - printDialog
```
public boolean printDialog(PrintRequestAttributeSet attributes)
                    throws HeadlessException
```
    Метод удобства, который выводит на экран межплатформенное диалоговое окно печати для всех служб, которые способны к печати 2-D графики, используя Pageable интерфейс. Выбранный принтер, когда диалоговое окно первоначально выводится на экран, отразит службу печати, в настоящий момент присоединенную к этому заданию печати. Если пользователь изменит службу печати, то PrinterJob будет обновлен, чтобы отразить это, если пользователь не отменит диалоговое окно. Так же как разрешая пользователю выбрать целевой принтер, пользователь может также выбрать значения различных атрибутов запроса печати.
    Параметр атрибутов на вводе отразит приложения требуемые начальные выборы в пользовательском диалоговом окне. Атрибуты не определенный дисплей, используя значение по умолчанию для службы. По возврату это отразит варианты пользователя. Выборы могут быть обновлены реализацией, чтобы быть непротиворечивыми с поддерживаемыми значениями для в настоящий момент выбранной службы печати.
    Поскольку пользователь прокручивает к новому выбору службы печати, скопированные значения основаны на настройках для предыдущей службы, вместе с любыми пользовательскими изменениями. Значения не основаны на исходных настройках, предоставленных клиентом.
    За исключением выбранного принтера, состояние PrinterJob не обновляется, чтобы отразить изменения пользователя. Для выборов, чтобы влиять на задание принтера, атрибуты должны быть определены в звонке print(PrintRequestAttributeSet) метод. Используя Листаемый интерфейс, клиенты, которые намереваются использовать носители, выбранные пользователем, должны создать PageFormat, полученный из выборов пользователя. Если пользователь отменит диалоговое окно, то атрибуты не будут отражать изменений, произведенных пользователем.
    
    Параметры:
    attributes - на вводе приложение предоставленные атрибуты, на выводе, содержание обновляется, чтобы отразить пользовательские варианты. Этот параметр, возможно, не нуль.
    
    Возвраты:
    true если пользователь не отменяет диалоговое окно; false иначе.
    
    Броски:
    
    HeadlessException - если GraphicsEnvironment.isHeadless () возвращает true.
    
    NullPointerException - если attributes параметр является нулем.
    С тех пор:
    
    1.4
    
    См. Также:
    GraphicsEnvironment.isHeadless()
  - pageDialog
```
public abstract PageFormat pageDialog(PageFormat page)
                               throws HeadlessException
```
    Выводит на экран диалоговое окно, которое позволяет модификацию a PageFormat экземпляр. page параметр используется, чтобы инициализировать средства управления в диалоговом окне установки страницы. Если пользователь отменяет диалоговое окно тогда, этот метод возвращает оригинал page неизмененный объект. Если пользователь одобряет диалоговое окно тогда, этот метод возвращает новое PageFormat объект с обозначенными изменениями. В любом случае, оригинале page объект не изменяется.
    
    Параметры:
    page - значение по умолчанию PageFormat представленный пользователю для модификации
    
    Возвраты:
    оригинал page возразите, отменяется ли диалоговое окно; новое PageFormat объект, содержащий формат, обозначенный пользователем, если диалоговое окно подтверждается.
    
    Броски:
    
    HeadlessException - если GraphicsEnvironment.isHeadless () возвращает true.
    С тех пор:
    
    1.2
    
    См. Также:
    GraphicsEnvironment.isHeadless()
  - pageDialog
```
public PageFormat pageDialog(PrintRequestAttributeSet attributes)
                      throws HeadlessException
```
    Метод удобства, который выводит на экран межплатформенную страницу, устанавливает диалоговое окно. Доступные варианты отразят службу печати, в настоящий момент установленную на этом PrinterJob.
    Параметр атрибутов на вводе отразит необходимые начальные выборы клиента в пользовательском диалоговом окне. Атрибуты, которые не определяются дисплей, используя значение по умолчанию для службы. По возврату это отразит варианты пользователя. Выборы могут быть обновлены реализацией, чтобы быть непротиворечивыми с поддерживаемыми значениями для в настоящий момент выбранной службы печати.
    Возвращаемым значением будет PageFormat, эквивалентный выборам в PrintRequestAttributeSet. Если пользователь отменит диалоговое окно, то атрибуты не будут отражать изменений, произведенных пользователем, и возвращаемое значение будет нулем.
    
    Параметры:
    attributes - на вводе приложение предоставленные атрибуты, на выводе, содержание обновляется, чтобы отразить пользовательские варианты. Этот параметр, возможно, не нуль.
    
    Возвраты:
    формат страницы, если пользователь не отменяет диалоговое окно; null иначе.
    
    Броски:
    
    HeadlessException - если GraphicsEnvironment.isHeadless () возвращает true.
    
    NullPointerException - если attributes параметр является нулем.
    С тех пор:
    
    1.4
    
    См. Также:
    GraphicsEnvironment.isHeadless()
  - defaultPage
```
public abstract PageFormat defaultPage(PageFormat page)
```
    Клоны PageFormat параметр и изменяет клона, чтобы описать размер страницы по умолчанию и ориентацию.
    
    Параметры:
    page - PageFormat быть клонированным и измененным
    
    Возвраты:
    клон page, измененный, чтобы описать значение по умолчанию PageFormat.
  - defaultPage
```
public PageFormat defaultPage()
```
    Создает новое PageFormat экземпляр и наборы это к размеру по умолчанию и ориентации.
    
    Возвраты:
    a PageFormat набор к размеру по умолчанию и ориентации.
  - getPageFormat
```
public PageFormat getPageFormat(PrintRequestAttributeSet attributes)
```
    Вычисляет a PageFormat со значениями, непротиворечивыми с поддерживаемыми током PrintService для этого задания (то есть значение, возвращенное getPrintService()) и носители, печатаемая область и ориентация, содержавшаяся в attributes.
    Вызов этого метода не обновляет задание. Это полезно для клиентов, которым получили ряд атрибутов от printDialog(PrintRequestAttributeSet attributes) и нуждаюсь в PageFormat, чтобы напечатать Листаемый объект.
    
    Параметры:
    attributes - ряд атрибутов печати, например полученных из вызова printDialog. Если attributes нуль, PageFormat по умолчанию возвращается.
    
    Возвраты:
    a PageFormat чьи настройки соответствуют таковым из текущей службы и указанных атрибутов.
    С тех пор:
    
    1.6
  - validatePage
```
public abstract PageFormat validatePage(PageFormat page)
```
    Возвращает клона page с его настройками, скорректированными, чтобы быть совместимым с текущим принтером этого PrinterJob. Например, возвращенный PageFormat могли скорректировать его вызывающую мысленный образ область, чтобы соответствовать в пределах физической области бумаги, которая используется текущим принтером.
    
    Параметры:
    page - PageFormat это клонируется и чьи настройки изменяются, чтобы быть совместимыми с текущим принтером
    
    Возвраты:
    a PageFormat это клонируется от page и чьи настройки изменяются, чтобы соответствовать этому PrinterJob.
  - печать
```
public abstract void print()
                    throws PrinterException
```
    Печатные издания ряд страниц.
    
    Броски:
    
    PrinterException - ошибка в системе печати, вызванной задание, которое будет прервано.
    См. Также:
    Book, Pageable, Printable
  - печать
```
public void print(PrintRequestAttributeSet attributes)
           throws PrinterException
```
    Печатные издания ряд страниц, используя настройки в атрибуте устанавливаются. Реализация по умолчанию игнорирует набор атрибута.
    Отметьте, что некоторые атрибуты могут быть установлены непосредственно на PrinterJob эквивалентными вызовами метода, (например), копиями: setcopies(int), имя задания: setJobName(String) и определяя размер носителей и ориентацию, хотя PageFormat объект.
    Если поддерживаемое значение атрибута будет определено в этом наборе атрибута, то оно будет иметь приоритет по настройкам API для этой печати () работа только. Следующее поведение определяется для PageFormat: Если клиент использует Печатаемый интерфейс, то attributes параметр к этому методу исследуется на атрибуты, которые определяют носители (размером), ориентация, и вызывающая мысленный образ область, и те используются, чтобы создать новый PageFormat, который передают к печати Печатаемого объекта () метод. См. Printable для объяснения необходимого поведения Печатаемого гарантировать оптимальную печать через PrinterJob. Для клиентов Листаемого интерфейса PageFormat будет всегда как предоставляться тем интерфейсом, на на основание страницы.
    Эти поведения позволяют приложению непосредственно передавать пользовательские настройки, возвращенные из printDialog(PrintRequestAttributeSet attributes к этой печати () метод.
    
    Параметры:
    attributes - ряд атрибутов для задания
    
    Броски:
    
    PrinterException - ошибка в системе печати, вызванной задание, которое будет прервано.
    С тех пор:
    
    1.4
    
    См. Также:
    Book, Pageable, Printable
  - setCopies
```
public abstract void setCopies(int copies)
```
    Определяет номер копий, которые будут напечатаны.
    
    Параметры:
    copies - число копий, которые будут напечатаны
    См. Также:
    getCopies()
  - getCopies
```
public abstract int getCopies()
```
    Заставляет число копий быть напечатанным.
    
    Возвраты:
    число копий, которые будут напечатаны.
    См. Также:
    setCopies(int)
  - getUserName
```
public abstract String getUserName()
```
    Получает имя пользователя печати.
    
    Возвраты:
    имя пользователя печати
  - setJobName
```
public abstract void setJobName(String jobName)
```
    Определяет имя документа, который будет напечатан. Название документа не может быть null.
    
    Параметры:
    jobName - имя документа, который будет напечатан
    См. Также:
    getJobName()
  - getJobName
```
public abstract String getJobName()
```
    Заставляет имя документа быть напечатанным.
    
    Возвраты:
    имя документа, который будет напечатан.
    См. Также:
    setJobName(java.lang.String)
  - отмена
```
public abstract void cancel()
```
    Отменяет задание печати, которое происходит. Если print был вызван, но не возвратился тогда, этот метод сигнализирует, что задание должно быть отменено в следующем шансе. Если нет никакого происходящего задания печати тогда, этот вызов ничего не делает.
  - isCancelled
```
public abstract boolean isCancelled()
```
    Возвраты true если задание печати происходит, но собирается быть отмененным в следующей возможности; иначе возвраты false.
    
    Возвраты:
    true если происходящее задание собирается быть отмененным; false иначе.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс PrinterJob

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Деталь конструктора

PrinterJob

Деталь метода

getPrinterJob

lookupPrintServices

lookupStreamPrintServices

getPrintService

setPrintService

setPrintable

setPrintable

setPageable

printDialog

printDialog

pageDialog

pageDialog

defaultPage

defaultPage

getPageFormat

validatePage

печать

печать

setCopies

getCopies

getUserName

setJobName

getJobName

отмена

isCancelled