Spec-Zone .ru
спецификации, руководства, описания, API
|
Содержание | Предыдущий | Затем |
API Печати Java включает приложениям к:
Не все эти функции поддерживаются в Java™ 2 API Печати SDK и реализация. API будет расширен, чтобы поддерживать все эти функции в будущих выпусках. Например, дополнительные средства управления принтером будут добавлены, увеличивая набор именованных свойств задания печати, которым может управлять приложение.
API Печати Java основан на модели печати обратного вызова, в которой система печати, не приложение, управляет, когда страницы печатаются. Приложение предоставляет информацию о документе, который будет напечатан, и система печати просит, чтобы приложение представило каждую страницу, поскольку это нуждается в них.
Система печати могла бы запросить, чтобы определенная страница была представлена не раз или запросила, чтобы страницы были представлены не в порядке. Приложение должно быть в состоянии генерировать надлежащее изображение страницы, независимо от того которые листают системные запросы печати. В этом отношении система печати подобна инструментарию окна, который может запросить компоненты перекрасить в любое время в любом порядке.
Модель печати обратного вызова более гибка чем традиционные управляемые приложением модели печати и поддерживает печать на более широком диапазоне систем и принтеров. Например, если принтер складывает выходные страницы в обратном порядке, система печати может попросить, чтобы приложение генерировало страницы в обратном порядке так, чтобы заключительный стек был в надлежащем порядке чтения.
Эта модель также позволяет приложениям напечатать к растровому принтеру от компьютеров, у которых нет достаточного пространства памяти или дискового пространства, чтобы буферизовать полностраничный битовый массив. В этой ситуации страница печатается как серия маленьких битовых массивов или полос. Например, если только достаточно памяти, чтобы буферизовать одну десятую страницы доступно, страница делится на десять полос. Система печати просит, чтобы приложение представило каждую страницу десять раз, однажды заполнить каждую полосу. Приложение не должно знать о числе или размере полос; это просто должно быть в состоянии представить каждую страницу когда требующийся.
Приложение должно выполнить две задачи поддерживать печать:
Пользователь часто инициирует печать, нажимая кнопку или выбирая пункт меню в приложении. Когда работа печати инициирована пользователем, приложение создает a PrinterJob
объект и использование это, чтобы управлять процессом печати.
Приложение ответственно за установку задания печати, выводя на экран диалоговые окна печати пользователю, и запуская процесс печати.
Когда документ печатается, приложение должно представить каждую страницу, когда система печати запрашивает это. Чтобы поддерживать этот механизм, приложение предоставляет живописцу страницы, который реализует Printable
интерфейс. Когда система печати нуждается в представленной странице, она вызывает живописца страницы print
метод.
Когда живописец страницы print
метод вызывают, его передают a Graphics
контекст, чтобы использовать, чтобы представить изображение страницы. Это также передают a PageFormat
объект, который определяет геометрическое расположение страницы, и целочисленной страницы, индексирует, который идентифицирует порядковую позицию страницы на задании печати.
Система печати поддерживает обоих Graphics
и Graphics2D
рендеринг, Чтобы напечатать Java 2D™ Shapes
, Text
, и Images
, Вы бросаете Graphics
объект, который передают в print
метод к a Graphics2D
.
Чтобы напечатать документы, в которых страницы используют различных живописцев страницы и имеют различные форматы, Вы используете листаемое задание. Чтобы создать листаемое задание, можно использовать Book
class или Ваша собственная реализация Pageable
интерфейс. Чтобы реализовать простые операции печати, Вы не должны использовать листаемое задание печати; Printable
может использоваться, пока все страницы совместно используют тот же самый формат страницы и живописца.
Основное задание живописца страницы должно представить страницу, используя графический контекст, который обеспечивается системой печати. Живописец страницы реализует Printable
.print
метод:
Графический контекст, который передают к print
метод является любой экземпляром Graphics
или Graphics2D
, В зависимости от пакетов, загруженных в Вашей виртуальной машине Java. Использовать Graphics2D
функции, можно бросить Graphics
возразите против a Graphics2D
. Graphics
экземпляр, к которому передают print
также реализации PrinterGraphics
интерфейс.
PageFormat
переданный к a Printable
описывает геометрию напечатанной страницы. Система координат графического контекста, к которому передают print
фиксируется к странице: источник системы координат в левом верхнем углу бумаги, X увеличений направо, Y увеличивается вниз, и модули являются дюймом 1/72. Если страница находится в портретной ориентации, ось X выравнивается с “width бумаги,” в то время как ось Y выравнивается с “height бумаги.” (Обычно, но не всегда, height бумаги превышает свой width.), Если страница находится в альбомной ориентации, роли инвертируются: ось X выравнивается с “height” бумаги и осью Y с ее “width.”
Поскольку много принтеров не могут напечатать на всей бумажной поверхности, PageFormat
определяет вызывающую мысленный образ область страницы: это - часть страницы, в которой безопасно представить. Спецификация вызывающей мысленный образ области не изменяет систему координат; это обеспечивается так, чтобы содержание страницы могло быть представлено так, чтобы они не расширились в область, где принтер не может напечатать.
Графический контекст, к которому передают print
имеет область клипа, которая описывает часть вызывающей мысленный образ области, которая должна быть оттянута. Всегда безопасно вовлечь всю страницу в контекст; система печати обработает необходимое отсечение. Однако, чтобы устранить издержки рисования частей страницы, которая не будет напечатана, можно использовать область отсечения, чтобы ограничить области, которые Вы представляете. Чтобы получить область отсечения от графического контекста, вызвать Graphics.getClip
. Вы строго поощряетесь использовать область клипа, чтобы уменьшить издержки рендеринга.
Это является иногда требуемым, чтобы запустить всю работу печати "в фоновом режиме" так, чтобы пользователь мог продолжать взаимодействовать с приложением, в то время как страницы представляются. Чтобы сделать это, вызвать PrinterJob.print
в отдельном потоке.
Если возможный, следует избежать графических операций, которые требуют знания предыдущего содержания изображения, такой как copyArea
, setXOR
, и составление композита. Эти операции могут замедлить рендеринг, и результаты могли бы быть непоследовательными.
A Printable
задание обеспечивает самый простой способ напечатать. Живописец на только одну страницу используется; приложение обеспечивает единственный class, который реализует Printable
интерфейс. Когда пора напечатать, системные вызовы печати живописец страницы print
метод, чтобы представить каждую страницу. Страницы требуют в порядке, запускающийся со страницы индексируют 0. Однако, живописца страницы можно было бы попросить представить каждую страницу несколько раз прежде, чем она будет совершенствоваться к следующей странице. Когда последняя страница была напечатана, метод печати живописца страницы возвращает NO_SUCH_PAGE.
В a Printable
задание:
PageFormat
. Если диалоговое окно печати будет представлено, то оно не будет выводить на экран число страниц в документе, потому что та информация не доступна системе печати.A Pageable
задание более гибко чем a Printable
задание. В отличие от страниц в a Printable
задание, страницы в a Pageable
задание может отличаться по расположению и реализации. Управлять a Pageable
задание, можно использовать Book
class или реализация Ваше собственное Pageable
class. Через Pageable
, система печати может определить число страниц, чтобы напечатать, живописец страницы, чтобы использовать для каждой страницы, и PageFormat
использовать для каждой страницы. Приложения, которые должны напечатать документы, у которых есть запланированная структура и формат, должны использовать Pageable
задания.
В a Pageable
задание:
PageFormats
.Pageable
задания не должны знать заранее, сколько страниц находится в документе. Однако, в отличие от этого Printable
задания, они должны быть в состоянии представить страницы в любом порядке. Могли бы быть разрывы в упорядочивании, и система печати могла бы запросить, чтобы страница была представлена многократно прежде, чем переместиться в следующую страницу. Например, запрос, чтобы напечатать страницы 2 и 3 документа мог бы привести к последовательности вызовов, которые запрашивают страницы с индексами 2,2,1,1, и 1.Приложение держится PrinterJob
объект через последовательность шагов, чтобы завершить задание печати. Самая простая последовательность, используемая приложением:
PrinterJob
объект, вызывая PrinterJob.getPrinterJob
.PageFormat
использовать для того, чтобы напечатать. Значение по умолчанию PageFormat
может быть получен, вызывая defaultPage
или можно вызвать pageDialog
представить диалоговое окно, которое позволяет пользователю определять формат.PrinterJob
. Для a Printable
задание, вызвать setPrintable
; для a Pageable
задание, вызвать setPageable
. Отметьте это a Book
объект идеален для того, чтобы передать к setPageable
.printDialog
представить диалоговое окно пользователю. Это является дополнительным. Содержание и появление этого диалогового окна могут измениться через различные платформы и принтеры. На большинстве платформ пользователь может использовать это диалоговое окно, чтобы изменить выбор принтера. Если пользователь отменяет задание печати, printDialog
возвраты метода FALSE
.Printerjob.print
напечатать задание. Этот метод поочередно вызывает print
на соответствующих живописцах страницы.Задание может быть прервано во время печати если:
PrinterException
бросается — исключение поймано print
метод и задание останавливаются. Живописец страницы бросает a PrinterException
если это обнаруживает фатальную ошибку.PrinterJob.cancel
вызывается — цикл печати завершается, и задание отменяется. cancel
метод можно вызвать от отдельного потока, который выводит на экран диалоговое окно и позволяет пользователю отменять печать, нажимая кнопку в поле.Страницы, сгенерированные перед заданием печати, останавливаются, мог бы или не мог бы быть напечатан.
Задание печати обычно не заканчивается когда print
возвраты метода. Работа обычно все еще делается драйвером принтера, сервером печати, или принтером непосредственно. Состояние PrinterJob
объект не мог бы отразить состояние фактического напечатанного задания.
Поскольку состояние a PrinterJob
изменения во время его жизненного цикла, это недопустимо, чтобы вызвать определенные методы в определенные времена. Например, вызов setPageable
после того, как Вы вызвали print
не имеет никакого смысла. Когда недопустимые вызовы обнаруживаются, PrinterJob
броски a java.lang.IllegalStateException
.
API Печати Java требует, чтобы приложения вызвали диалоговые окна пользовательского интерфейса явно. Эти диалоговые окна могли бы быть обеспечены программным обеспечением платформы (таким как Windows) или Java™ 2 реализации программного обеспечения SDK. Для интерактивных приложений это общепринято, чтобы использовать такие диалоговые окна. Для производственных приложений печати, однако, диалоговые окна не необходимы. Например, Вы не хотели бы выводить на экран диалоговое окно, автоматически генерируя и печатая ночной отчет базы данных. Задание печати, которое не требует никакого взаимодействия с пользователем, иногда вызывают тихим заданием печати.
Можно позволить пользователю изменять информацию об установке страницы, содержавшуюся в a PageFormat
выводя на экран страницу устанавливают диалоговое окно. Чтобы вывести на экран страницу устанавливают диалоговое окно, Вы вызываете PrinterJob.pageDialog
. Диалоговое окно установки страницы инициализируется, используя параметр, к которому передают pageDialog
. Если пользователь щелкает по кнопке OK в диалоговом окне, PageFormat
экземпляр клонируется, изменяется, чтобы отразить выборы пользователя, и затем возвращается. Если пользователь отменяет диалоговое окно, pageDialog
возвращает неизменный оригинал PageFormat
.
Как правило, приложение представляет диалоговое окно печати пользователю, когда пункт меню печати или кнопка активируются. Чтобы вывести на экран это диалоговое окно печати, Вы вызываете PrinterJob’s printDialog
метод. Варианты пользователя в диалоговом окне ограничиваются основанные на числе и формате страниц в Printable
или Pageable
это было оснащено к PrinterJob
. Если пользователь нажимает OK в диалоговом окне печати, printDialog
возвраты TRUE
. Если пользователь отменяет диалоговое окно печати, FALSE
возвращается и задание печати нужно считать отказавшимся.
Оказывать основную поддержку печати:
Printable
интерфейс, чтобы предоставить живописцу страницы, который может представить каждую страницу, которая будет напечатана.PrinterJob
.setPrintable
сказать PrinterJob
как напечатать Ваш документ.print
на PrinterJob
возразите, чтобы запустить задание.В следующем примере, a Printable
задание используется, чтобы напечатать пять страниц, каждые из которых выводят на экран зеленый номер страницы. Управлением заданиями управляют в main
метод, который получает и управляет PrinterJob
. Рендеринг выполняется в живописце страницы print
метод.
import java.awt.*; import java.awt.print.*; public class SimplePrint implements Printable { private static Font fnt = new Font("Helvetica",Font.PLAIN,24); public static void main(String[] args) { // Get a PrinterJob PrinterJob job = PrinterJob.getPrinterJob(); // Specify the Printable is an instance of SimplePrint job.setPrintable(new SimplePrint()); // Put up the dialog box if (job.printDialog()) { // Print the job if the user didn't cancel printing try { job.print(); } catch (Exception e) { /* handle exception */ } } System.exit(0); } public int print(Graphics g, PageFormat pf, int pageIndex) throws PrinterException { // pageIndex 0 to 4 corresponds to page numbers 1 to 5. if (pageIndex >= 5) return Printable.NO_SUCH_PAGE; g.setFont(fnt); g.setColor(Color.green); g.drawString("Page " + (pageIndex+1), 100, 100); return Printable.PAGE_EXISTS; } }
Можно вызвать Graphics2D
функции в Вас метод печати живописца страницы первым кастингом Graphics
контекст к a Graphics2D
.
В следующем примере номера страниц представляются, используя красно-зеленый градиент. Сделать это, a GradientPaint
устанавливается в Graphics2D
контекст.
import java.awt.*; import java.awt.print.*; public class SimplePrint2D implements Printable { private static Font fnt = new Font("Helvetica",Font.PLAIN,24); private Paint pnt = new GradientPaint(100f, 100f, Color.red, 136f, 100f, Color.green, true); public static void main(String[] args) { // Get a PrinterJob PrinterJob job = PrinterJob.getPrinterJob(); // Specify the Printable is an instance of SimplePrint2D job.setPrintable(new SimplePrint2D()); // Put up the dialog box if (job.printDialog()) { // Print the job if the user didn't cancel printing try { job.print(); } catch (Exception e) { /* handle exception */ } } System.exit(0); } public int print(Graphics g, PageFormat pf, int pageIndex) throws PrinterException { // pageIndex 0 to 4 corresponds to page numbers 1 to 5. if (pageIndex >= 5) return Printable.NO_SUCH_PAGE; Graphics2D g2 = (Graphics2D) g; // Use the font defined above g2.setFont(fnt); // Use the gradient color defined above g2.setPaint(pnt); g2.drawString("Page " + (pageIndex+1), 100f, 100f); return Printable.PAGE_EXISTS; } }
Когда метод печати живописца страницы вызывается несколько раз для той же самой страницы, он должен генерировать тот же самый вывод каждый раз.
Есть много способов гарантировать, что повторные запросы, чтобы представить страницу приводят к тому же самому выводу. Например, чтобы гарантировать, что тот же самый вывод сгенерирован каждый раз, когда система печати запрашивает определенную страницу текстового файла, живописец страницы мог или сохранить и указатели файла повторного использования для каждой страницы или хранить фактические данные страницы.
В следующем примере печатается "перечисление" текстового файла. Имя файла передают как параметр main
метод. PrintListingPainter
class хранит указатель файла в действительности в начале каждой новой страницы, которую просят представить. Когда та же самая страница представляется снова, указатель файла сбрасывается к помнившей позиции.
import java.awt.*; import java.awt.print.*; import java.io.*; public class PrintListing { public static void main(String[] args) { // Get a PrinterJob PrinterJob job = PrinterJob.getPrinterJob(); // Ask user for page format (e.g., portrait/landscape) PageFormat pf = job.pageDialog(job.defaultPage()); // Specify the Printable is an instance of // PrintListingPainter; also provide given PageFormat job.setPrintable(new PrintListingPainter(args[0]), pf); // Print 1 copy job.setCopies(1); // Put up the dialog box if (job.printDialog()) { // Print the job if the user didn't cancel printing try { job.print(); } catch (Exception e) { /* handle exception */ } } System.exit(0); } } class PrintListingPainter implements Printable { private RandomAccessFile raf; private String fileName; private Font fnt = new Font("Helvetica", Font.PLAIN, 10); private int rememberedPageIndex = -1; private long rememberedFilePointer = -1; private boolean rememberedEOF = false; public PrintListingPainter(String file) { fileName = file; try { // Open file raf = new RandomAccessFile(file, "r"); } catch (Exception e) { rememberedEOF = true; } } public int print(Graphics g, PageFormat pf, int pageIndex) throws PrinterException { try { // For catching IOException if (pageIndex != rememberedPageIndex) { // First time we've visited this page rememberedPageIndex = pageIndex; // If encountered EOF on previous page, done if (rememberedEOF) return Printable.NO_SUCH_PAGE; // Save current position in input file rememberedFilePointer = raf.getFilePointer(); } else raf.seek(rememberedFilePointer); g.setColor(Color.black); g.setFont(fnt); int x = (int) pf.getImageableX() + 10; int y = (int) pf.getImageableY() + 12; // Title line g.drawString("File: " + fileName + ", page: " + (pageIndex+1), x, y); // Generate as many lines as will fit in imageable area y += 36; while (y + 12 < pf.getImageableY()+pf.getImageableHeight()) { String line = raf.readLine(); if (line == null) { rememberedEOF = true; break; } g.drawString(line, x, y); y += 12; } return Printable.PAGE_EXISTS; } catch (Exception e) { return Printable.NO_SUCH_PAGE;} } }
Pageable
задания подходят для приложений, которые создают явное представление документа, постранично. Book
class является удобным способом использовать Pageables
, но можно также создать свое собственное Pageable
структуры, если Book
не удовлетворяет Вашим потребностям. Этот раздел показывает Вам, как использовать Book
.
Хотя немного более включенный, Pageable
задания предпочитаются Printable
задания, потому что у системы печати есть больше гибкости. Главное преимущество Pageables
это, число страниц в документе обычно известно и может быть выведено на экран пользователю в диалоговом окне печати. Это помогает пользователю подтвердить, что задание определяется правильно или выбрать диапазон страниц для того, чтобы напечатать.
A Book
представляет набор страниц. Страницы в книге не должны совместно использовать тот же самый размер, ориентацию, или живописца страницы. Например, a Book
мог бы содержать две страницы размера буквы в портретной ориентации и страницу размера буквы в альбомной ориентации.
Когда a Book
сначала создается, это пусто. Добавить страницы к a Book
, Вы используете append
метод. Этот метод берет a PageFormat
объект, который определяет размер страницы, печатаемую область, и ориентацию и живописца страницы, который реализует Printable
интерфейс.
Многократные страницы в a Book
может совместно использовать тот же самый формат страницы и живописца. append
метод перегружается, чтобы позволить Вам добавить серию страниц, у которых есть те же самые атрибуты, определяя третий параметр, число страниц.
Если Вы не знаете общее количество страниц в a Book
, можно передать UNKNOWN_NUMBER_OF_PAGES
к append
метод. Система печати тогда вызовет Ваших живописцев страницы в порядке увеличивающейся страницы, индексируют до одного из них возвраты NO_SUCH_PAGE
.
setPage
метод может использоваться, чтобы изменить формат страницы страницы или живописца. Страница, которая будет изменена, идентифицируется страницей, индексируют, который указывает на расположение страницы в Book
.
Вы вызываете setPageable
и передача в Book
подготовить задание печати. setPageable
и setPrintable
методы являются взаимоисключающими; то есть, следует вызвать один или другой, но не оба, готовясь PrinterJob
.
В следующем примере, a Book
используется, чтобы воспроизвести первый простой пример печати. (Поскольку этот случай настолько прост, есть небольшое преимущество в использовании a Pageable
задание вместо a Printable
задание, но это иллюстрирует основы использования a Book
.) Отмечают, что все еще необходимо реализовать Printable
соедините интерфейсом и выполните рендеринг страницы в живописце страницы print
метод.
import java.awt.*; import java.awt.print.*; public class SimplePrintBook implements Printable { private static Font fnt = new Font("Helvetica",Font.PLAIN,24); public static void main(String[] args) { // Get a PrinterJob PrinterJob job = PrinterJob.getPrinterJob(); // Set up a book Book bk = new Book(); bk.append(new SimplePrintBook(), job.defaultPage(), 5); // Pass the book to the PrinterJob job.setPageable(bk); // Put up the dialog box if (job.printDialog()) { // Print the job if the user didn't cancel printing try { job.print(); } catch (Exception e) { /* handle exception */ } } System.exit(0); } public int print(Graphics g, PageFormat pf, int pageIndex) throws PrinterException { g.setFont(fnt); g.setColor(Color.green); g.drawString("Page " + (pageIndex+1), 100, 100); return Printable.PAGE_EXISTS; } }
В следующем примере используются два различных живописца страницы: один для титульного листа и один для страниц контента. Титульный лист печатается в альбомном режиме, и страницы содержания печатаются в режиме портрета.
import java.awt.*; import java.awt.print.*; public class PrintBook { public static void main(String[] args) { // Get a PrinterJob PrinterJob job = PrinterJob.getPrinterJob(); // Create a landscape page format PageFormat pfl = job.defaultPage(); pfl.setOrientation(PageFormat.LANDSCAPE); // Set up a book Book bk = new Book(); bk.append(new PaintCover(), pfl); bk.append(new PaintContent(), job.defaultPage(), 2); // Pass the book to the PrinterJob job.setPageable(bk); // Put up the dialog box if (job.printDialog()) { // Print the job if the user didn't cancel printing try { job.print(); } catch (Exception e) { /* handle exception */ } } System.exit(0); } } class PaintCover implements Printable { Font fnt = new Font("Helvetica-Bold", Font.PLAIN, 72); public int print(Graphics g, PageFormat pf, int pageIndex) throws PrinterException { g.setFont(fnt); g.setColor(Color.black); int yc = (int) (pf.getImageableY() + pf.getImageableHeight()/2); g.drawString("Widgets, Inc.", 72, yc+36); return Printable.PAGE_EXISTS; } } class PaintContent implements Printable { public int print(Graphics g, PageFormat pf, int pageIndex) throws PrinterException { Graphics2D g2 = (Graphics2D) g; int useRed = 0; int xo = (int) pf.getImageableX(); int yo = (int) pf.getImageableY(); // Fill page with circles or squares, alternating red & green for (int x = 0; x+28 < pf.getImageableWidth(); x += 36) for (int y = 0; y+28 < pf.getImageableHeight(); y += 36) { if (useRed == 0) g.setColor(Color.red); else g.setColor(Color.green); useRed = 1 - useRed; if (pageIndex % 2 == 0) g.drawRect(xo+x+4, yo+y+4, 28, 28); else g.drawOval(xo+x+4, yo+y+4, 28, 28); } return Printable.PAGE_EXISTS; } }
Содержание | Предыдущий | Затем |