Spec-Zone .ru
спецификации, руководства, описания, API
|
public abstract class PrinterJob extends Object
PrinterJob
class является основной class, который управляет печатью. Приложение вызывает методы в этом class, чтобы установить задание, дополнительно вызвать диалоговое окно печати с пользователем, и затем напечатать страницы задания.Конструктор и Описание |
---|
PrinterJob()
A
PrinterJob объект должен быть создан, используя помехи метод. |
Модификатор и Тип | Метод и Описание |
---|---|
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 . |
public PrinterJob()
PrinterJob
объект должен быть создан, используя помехи getPrinterJob
метод.public static PrinterJob getPrinterJob()
PrinterJob
который первоначально связывается с принтером значения по умолчанию. Если никакие принтеры не будут доступны на системе, то PrinterJob будет все еще возвращен из этого метода, но getPrintService()
возвратится null
, и вызов print
с этим PrinterJob
мог бы генерировать исключение. Приложения, которые должны определить, есть ли подходящие принтеры прежде, чем создать a PrinterJob
должен гарантировать что массив, возвращенный из lookupPrintServices
не пусто.PrinterJob
.SecurityException
- если менеджер безопасности существует и SecurityManager.checkPrintJobAccess()
метод отвергает этот поток от создания запроса задания печатиpublic static PrintService[] lookupPrintServices()
PrinterJob
s, которые поддерживают службы печати. Вызов этого метода эквивалентен вызову PrintServiceLookup.lookupPrintServices()
и определяя Листаемый DocFlavor.public static StreamPrintServiceFactory[] lookupStreamPrintServices(String mimeType)
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
- необходимый выходной формат, или нуль, чтобы означать любой формат.public PrintService getPrintService()
setPrintService(PrintService)
, getPrinterJob()
public void setPrintService(PrintService service) throws PrinterException
PrinterException
если указанная служба не может поддерживать Pageable
и Printable
взаимодействует через интерфейс необходимый, чтобы поддерживать 2-D печать.service
- служба печати, которая поддерживает 2-D печатьPrinterException
- если указанная служба не поддерживает 2-D печать, или этот PrinterJob, class не поддерживает установку 2-D службы печати, или указанная служба является иначе не допустимой службой печати.getPrintService()
public abstract void setPrintable(Printable painter)
painter
представлять страницы. Страницы в документе, который будет напечатан этим PrinterJob
представляются Printable
объект, painter
. PageFormat
поскольку каждая страница является форматом страницы значения по умолчанию.painter
- Printable
это представляет каждую страницу документа.public abstract void setPrintable(Printable painter, PageFormat format)
painter
представлять страницы в указанном format
. Страницы в документе, который будет напечатан этим PrinterJob
представляются Printable
объект, painter
. PageFormat
из каждой страницы format
.painter
- Printable
вызванный, чтобы представить каждую страницу документаformat
- размер и ориентация каждой страницы, которая будет напечатанаpublic abstract void setPageable(Pageable document) throws NullPointerException
document
для числа страниц и PageFormat
и Printable
для каждой страницы, сдержанной Pageable
экземпляр, document
.document
- страницы, которые будут напечатаны. Это не может быть null
.NullPointerException
- Pageable
переданный в был null
.PageFormat
, Printable
public abstract boolean printDialog() throws HeadlessException
printDialog(PrintRequestAttributeSet)
. Реализации PrinterJob, которые могут использовать PrintService, обновят PrintService для этого PrinterJob, чтобы отразить новую службу, выбранную пользователем.
true
если пользователь не отменяет диалоговое окно; false
иначе.HeadlessException
- если GraphicsEnvironment.isHeadless () возвращает true.GraphicsEnvironment.isHeadless()
public boolean printDialog(PrintRequestAttributeSet attributes) throws HeadlessException
Pageable
интерфейс. Выбранный принтер, когда диалоговое окно первоначально выводится на экран, отразит службу печати, в настоящий момент присоединенную к этому заданию печати. Если пользователь изменит службу печати, то PrinterJob будет обновлен, чтобы отразить это, если пользователь не отменит диалоговое окно. Так же как разрешая пользователю выбрать целевой принтер, пользователь может также выбрать значения различных атрибутов запроса печати. Параметр атрибутов на вводе отразит приложения требуемые начальные выборы в пользовательском диалоговом окне. Атрибуты не определенный дисплей, используя значение по умолчанию для службы. По возврату это отразит варианты пользователя. Выборы могут быть обновлены реализацией, чтобы быть непротиворечивыми с поддерживаемыми значениями для в настоящий момент выбранной службы печати.
Поскольку пользователь прокручивает к новому выбору службы печати, скопированные значения основаны на настройках для предыдущей службы, вместе с любыми пользовательскими изменениями. Значения не основаны на исходных настройках, предоставленных клиентом.
За исключением выбранного принтера, состояние PrinterJob не обновляется, чтобы отразить изменения пользователя. Для выборов, чтобы влиять на задание принтера, атрибуты должны быть определены в звонке print(PrintRequestAttributeSet)
метод. Используя Листаемый интерфейс, клиенты, которые намереваются использовать носители, выбранные пользователем, должны создать PageFormat, полученный из выборов пользователя. Если пользователь отменит диалоговое окно, то атрибуты не будут отражать изменений, произведенных пользователем.
attributes
- на вводе приложение предоставленные атрибуты, на выводе, содержание обновляется, чтобы отразить пользовательские варианты. Этот параметр, возможно, не нуль.true
если пользователь не отменяет диалоговое окно; false
иначе.HeadlessException
- если GraphicsEnvironment.isHeadless () возвращает true.NullPointerException
- если attributes
параметр является нулем.GraphicsEnvironment.isHeadless()
public abstract PageFormat pageDialog(PageFormat page) throws HeadlessException
PageFormat
экземпляр. page
параметр используется, чтобы инициализировать средства управления в диалоговом окне установки страницы. Если пользователь отменяет диалоговое окно тогда, этот метод возвращает оригинал page
неизмененный объект. Если пользователь одобряет диалоговое окно тогда, этот метод возвращает новое PageFormat
объект с обозначенными изменениями. В любом случае, оригинале page
объект не изменяется.page
- значение по умолчанию PageFormat
представленный пользователю для модификацииpage
возразите, отменяется ли диалоговое окно; новое PageFormat
объект, содержащий формат, обозначенный пользователем, если диалоговое окно подтверждается.HeadlessException
- если GraphicsEnvironment.isHeadless () возвращает true.GraphicsEnvironment.isHeadless()
public PageFormat pageDialog(PrintRequestAttributeSet attributes) throws HeadlessException
Параметр атрибутов на вводе отразит необходимые начальные выборы клиента в пользовательском диалоговом окне. Атрибуты, которые не определяются дисплей, используя значение по умолчанию для службы. По возврату это отразит варианты пользователя. Выборы могут быть обновлены реализацией, чтобы быть непротиворечивыми с поддерживаемыми значениями для в настоящий момент выбранной службы печати.
Возвращаемым значением будет PageFormat, эквивалентный выборам в PrintRequestAttributeSet. Если пользователь отменит диалоговое окно, то атрибуты не будут отражать изменений, произведенных пользователем, и возвращаемое значение будет нулем.
attributes
- на вводе приложение предоставленные атрибуты, на выводе, содержание обновляется, чтобы отразить пользовательские варианты. Этот параметр, возможно, не нуль.null
иначе.HeadlessException
- если GraphicsEnvironment.isHeadless () возвращает true.NullPointerException
- если attributes
параметр является нулем.GraphicsEnvironment.isHeadless()
public abstract PageFormat defaultPage(PageFormat page)
PageFormat
параметр и изменяет клона, чтобы описать размер страницы значения по умолчанию и ориентацию.page
- PageFormat
быть клонированным и измененнымpage
, измененный, чтобы описать значение по умолчанию PageFormat
.public PageFormat defaultPage()
PageFormat
экземпляр и наборы это к размеру значения по умолчанию и ориентации.PageFormat
набор к размеру значения по умолчанию и ориентации.public PageFormat getPageFormat(PrintRequestAttributeSet attributes)
PageFormat
со значениями, непротиворечивыми с поддерживаемыми током PrintService
для этого задания (то есть значение, возвращенное getPrintService()
) и носители, печатаемая область и ориентация, содержавшаяся в attributes
. Вызов этого метода не обновляет задание. Это полезно для клиентов, которым получили ряд атрибутов от printDialog(PrintRequestAttributeSet attributes)
и нуждаюсь в PageFormat, чтобы напечатать Листаемый объект.
attributes
- ряд атрибутов печати, например полученных из вызова printDialog. Если attributes
нуль значение по умолчанию, PageFormat возвращается.PageFormat
чьи настройки соответствуют таковым из текущей службы и указанных атрибутов.public abstract PageFormat validatePage(PageFormat page)
page
с его настройками, скорректированными, чтобы быть совместимым с текущим принтером этого PrinterJob
. Например, возвращенный PageFormat
могли скорректировать его вызывающую мысленный образ область, чтобы соответствовать в пределах физической области бумаги, которая используется текущим принтером.page
- PageFormat
это клонируется и чьи настройки изменяются, чтобы быть совместимыми с текущим принтером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
- ошибка в системе печати, вызванной задание, которое будет прервано.Book
, Pageable
, Printable
public abstract void setCopies(int copies)
copies
- число копий, которые будут напечатаныgetCopies()
public abstract int getCopies()
setCopies(int)
public abstract String getUserName()
public abstract void setJobName(String jobName)
null
.jobName
- имя документа, который будет напечатанgetJobName()
public abstract String getJobName()
setJobName(java.lang.String)
public abstract void cancel()
print
был вызван, но не возвратился тогда, этот метод сигнализирует, что задание должно быть отменено в следующем шансе. Если нет никакого происходящего задания печати тогда, этот вызов ничего не делает.public abstract boolean isCancelled()
true
если задание печати происходит, но собирается быть отмененным в следующей возможности; иначе возвраты false
.true
если происходящее задание собирается быть отмененным; false
иначе.
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92