Класс PrinterJob

public PrinterJob()

public static PrinterJob getPrinterJob()

Возвращает:

новый PrinterJob.

public static PrintService[] lookupPrintServices()

Возвращает:

возможно, пустой массив служб печати 2D.

С версии:

1.4

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();
    }
}

Параметры:

mimeType — требуемый формат выходных данных или null, если допустим любой формат.

Возвращает:

возможно, пустой массив фабрик потоковых служб печати 2D.

С версии:

1.4

public PrintService getPrintService()

Возвращает:

службу для этого задания печати.

С версии:

1.4

См. также:

• setPrintService(PrintService)
• getPrinterJob()

public void setPrintService(PrintService service) throws PrinterException

Параметры:

service — служба печати, поддерживающая печать 2D

Выбрасывает:

PrinterException — если указанная служба не поддерживает печать 2D, этот класс PrinterJob не поддерживает установку службы печати 2D или указанная служба по иной причине не является допустимой службой печати.

С версии:

1.4

См. также:

• getPrintService()

public abstract void setPrintable(Printable painter)

Параметры:

painter — Printable, который отрисовывает каждую страницу документа.

public abstract void setPrintable(Printable painter, PageFormat format)

Параметры:

painter — Printable, вызываемый для отрисовки каждой страницы документа

format — размер и ориентация каждой печатаемой страницы

public abstract void setPageable(Pageable document) throws NullPointerException

Параметры:

document — страницы для печати. Не может быть null.

Выбрасывает:

NullPointerException — переданный Pageable был null.

См. также:

• PageFormat
• Printable

public abstract boolean printDialog() throws HeadlessException

Возвращает:

true, если пользователь не отменил диалоговое окно; в противном случае — false.

Выбрасывает:

HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

• GraphicsEnvironment.isHeadless()

public boolean printDialog(PrintRequestAttributeSet attributes) throws HeadlessException

Параметры:

attributes — при передаче содержит атрибуты, заданные приложением; при возврате обновляется с учетом выбора пользователя. Этот параметр не может быть null.

Возвращает:

true, если пользователь не отменил диалоговое окно; в противном случае — false.

Выбрасывает:

HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true.

NullPointerException — если параметр attributes равен null.

С версии:

1.4

См. также:

• GraphicsEnvironment.isHeadless()

public abstract PageFormat pageDialog(PageFormat page) throws HeadlessException

Параметры:

page — формат PageFormat по умолчанию, предлагаемый пользователю для изменения

Возвращает:

исходный объект page, если диалоговое окно отменено; новый объект PageFormat с форматом, указанным пользователем, если диалоговое окно подтверждено.

Выбрасывает:

HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true.

С версии:

1.2

См. также:

• GraphicsEnvironment.isHeadless()

public PageFormat pageDialog(PrintRequestAttributeSet attributes) throws HeadlessException

Параметры:

attributes — при передаче содержит атрибуты, заданные приложением; при возврате обновляется с учетом выбора пользователя. Этот параметр не может быть null.

Возвращает:

формат страницы, если пользователь не отменил диалоговое окно; в противном случае — null.

Выбрасывает:

HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true.

NullPointerException — если параметр attributes равен null.

С версии:

1.4

См. также:

• GraphicsEnvironment.isHeadless()

public abstract PageFormat defaultPage(PageFormat page)

Параметры:

page — PageFormat, который нужно клонировать и изменить

Возвращает:

клон page, измененный для описания PageFormat по умолчанию.

public PageFormat defaultPage()

Возвращает:

PageFormat с размером и ориентацией по умолчанию.

public PageFormat getPageFormat(PrintRequestAttributeSet attributes)

Параметры:

attributes — набор атрибутов печати, например полученный при вызове printDialog. Если attributes равен null, возвращается PageFormat по умолчанию.

Возвращает:

PageFormat, параметры которого соответствуют параметрам текущей службы и указанным атрибутам.

С версии:

1.6

public abstract PageFormat validatePage(PageFormat page)

Параметры:

page — PageFormat, который клонируется и настройки которого изменяются для соответствия текущему принтеру

Возвращает:

PageFormat, клонированный из page и настройки которого изменены в соответствии с этим PrinterJob.

public abstract void print() throws PrinterException

Выбрасывает:

PrinterException — ошибка в системе печати привела к прерыванию задания.

См. также:

• Book
• Pageable
• Printable

public void print(PrintRequestAttributeSet attributes) throws PrinterException

Параметры:

attributes — набор атрибутов задания

Выбрасывает:

PrinterException — ошибка в системе печати привела к прерыванию задания.

С версии:

1.4

См. также:

• 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)

Параметры:

jobName — имя печатаемого документа

См. также:

• getJobName()

public abstract String getJobName()

Возвращает:

имя печатаемого документа.

См. также:

• setJobName(String)

public abstract void cancel()

public abstract boolean isCancelled()

Возвращает:

true, если выполняющееся задание будет отменено; в противном случае — false.