Класс PrinterJob

public PrinterJob()

public static PrinterJob getPrinterJob()

Возвращает:

новый PrinterJob.

public static PrintService[] lookupPrintServices()

Возвращает:

возможно, пустой массив служб печати двумерной графики.

С версии:

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 для указания любого формата.

Возвращает:

возможно, пустой массив фабрик служб потоковой печати двумерной графики.

С версии:

1.4

public PrintService getPrintService()

Возвращает:

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

С версии:

1.4

См. также:

• setPrintService(PrintService)
• getPrinterJob()

public void setPrintService(PrintService service) throws PrinterException

Параметры:

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

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

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

С версии:

1.4

См. также:

• getPrintService()

public abstract void setPrintable(Printable painter)

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.