Áß ÍË Ä ÿßÁ ÿÀ
Í à : ÝÍ
| à |
|
Java Äé ÿéAPI é ÁÍ é Áß ÍË Ä ÞÁß Å
Å µ ÍË Å Ñ ÁÍ Íé Áßé ÍË Äé Ý ÑÎÀ Jean-Pierre Dube .ËÍ ËÁß À àé é é ß Ë ËÁß ÉÍ Ä ÅÔÁ ÎÁ ÿ Ð .Ëß ËÁß ÎÀ Íé àé ß àË Ú ßÁ .ÅÍ ËÁß Ñ Áß ÍË Ä ÿAPI ÅìÎ ÉÍ Ñ ÞßÁ à .Ëß ËÁß áÍ à Jean-Pierre Dube Ôß Ä Ã ÿßÍ Øéé é ß ÅÍË à ÜßÁ àÍ ÍË .ËËÀ Ñß Áß ÍË Ä ÿ µ áÍ ÍË é Ýééé Úéé é à à ÅÁ ÞÁ Þ ØË .ËÍ ËÁßÿ Ä ÍË Áß Îé éé ÿÁÍ ÁÍ àÁÍ ß à Í ÍÁÍ API ÿßÍ Í à Ë à ÿßÍ àé ËéËÿé àÎÁ ÃßÍ .Ëß Ò ÿßÍ à ÿÍËÍË ÎÁ ß Ë ééßË ß Íß ¬ÁÍÁÍ ß Ë ËÁ headers/footers ÁÍ Å .ËÎ ÁÍ |
ÜËé ß Ëßé ÝÁß ÉÍ ÿÁÍ ÁÍ Ä à ÔßÍ ÅÔÁ ¬Å ÞÁ ÍË
ééÍ ÞÁ ÍË àÍßÔ .Ëß ÝÁß ÿÍ ÿÁÍ ÁÍ API ß Áß Ä
é àéßé Å áÎÁË .Å ÞÀ API ÎÁ àË Á Ä ËË ËÁß
ÜË Þ à ÞÁ ß .Ë Ú ÅÁ Þ API ÎÁ Í àÍ Ú ÎÁ àË Á
ËÍßé ÍË àéßÁ ØÕß Ý à ÝÎ ÃßÍ Ú ÝÁßÿ à ÅÁ Ò
àéé ÍßÁ áÍÁÍ à ÜßÁ ËË àÎÁ Ð .Ëß àË ÞÀ ÍË áÎ à
¬Äé API ÍË Ëßéßé ÿÏßß ÉÍ ÎÁ Ü -à Ú ÉÍ .ÝÎÁËÍ
ÁÍ Ößß ,ËÁàË àË Á áÍ ÞÁ ÍË à ÅÔÁ ÿ ÉÍ ËË àÎÁ
ÍËé éÁ ËéÍÿ ÍÕ ÅÁ ÿ Ü ÍË ÅÔÁ ÞÁ à ÍÁ .Ý ÎÀ
.Ëéééé Üé (Margins) éà àÍÍË ÁÍ Ë ÿ Ëß ËÁß
ÞÀ ÍË .Ëßéé ÖÁÍé éÁ ÁÍ Ä Þ ÞßÁ ÛÍ ß à ËÍÁË ÖÔÁ Á
ÙÍÔ ÎÁ ÁÍ à Ú ÉÍÔ ËÁß à Ëßÿ àË Á ÿÁàÏÁß ÎÁ Ë ßÁ ÞÎ
.ÅÁ à Ú ÎÁ ÛÍ ß ÉÍ ÞÁ .Ë Ü ß àÎ ÞÀ
± Ü
² Ü
.ÅéÁ àËé Ýéééé Øéé ÿ à à à Ýÿ ² ß± ÿ ÍË
àé àé éÁß ÞÁ .ËËÿ Ü ÁÍ à ÿ Ë Ñ Í Í ÿà
Îéé Ìéé ÜÍ ß ÅÍ Å Í à ÅÁ ÿ ÜÁË ß àËß Í
àÎÁËéÁ ÅÍËéé é .ËË Í ËÁß ÿ ÍÍ ÁÍ Í Í ÿà .ËÍÁË
ÎÁ ÿé Á .Ýÿ àË Á À ÎÁ ß ÝÁËÿ ÁÍ Í Í ÿà
ÍË .ËéÁàËßéé ÉÍ àË ØÍ ÿß ÍË ÁÍ À Í Í ÞËÎ
Ò ÁÍ Ä ËÍß Ü ËÁ API .ÝÍÁË àÎÁËÁ Þ ÁË à Î Áß
àé ÿßÍ Å à Ë ÿà ¬Í Í ÿà ÜÁË ÍË .Ëÿ
ÁÍ àééé ÜßéÔ ÅéÁÍ ß Ä Å ÿà à Ë ÅË .ËÁàËÍ Ò ÁÍ
àééé Ú Ä Å Å ÍË Gutter .ËËÿ Þ Þ ß à ÿ
àËéé Ëß Ë ß ËßÍÿ à ÜÁË à Å à ÿÎ ÿÁÍ ÿÁ
Íé ÍË Äé ÿ à Ëßÿ Ä duplex mode ÅÍß Å àÎ ÍË .ÅÁ
ÅË ÿÁÍ .ÅÁ à Í ÍÕ ÍË ÿÁà Î ÅÁÍ Å ÍË Í ß ¬ÅÁ Å ßË
ß ÅéÁÍ Å ÍË ÁÍ Í ß ÿà Ë Ì ÍË àË Á ËÍß Ü Ü ÞËÍßÀ
Íé ßé àééé Üéé ¬API Ä .Ë àÁ ÞÀ à ß ËÍ ÍÕ ÍË Ä
Ãéé àì .Ë Ò ÁÍÀ ËÁß ÿ à Åß ÃßÍ Á ¬Ëßÿ
àÍ àÁÍ ÞÁÍ ¬ËÍÿ ÍÕ ÍË ÁÍ à Î API à Å ÞÁ ÍË
.Ëéééé ÝééÕéé ÁÍ Ä Ü à àÎÁËÁ ß Ü à ÅÁ ÞÁ ÍË
ÍË .Ëßéÿé àËéÁß Ä Ü à Ý à Ôß ÍË à ÞÁ ¬"
ÞÀ à à Ë BorderLayout à ÍÕ à ÅÁ Þ à ÉÍÔ ¬ÜßÁ à
àé Þ ß ÍË Ëßß ÿ BorderLayout ÍË à ÍÁ .ÝÁàËÍ ÅË
ÿéàéé à ÿÎ Ñ ÍË à ÍË ËÁÎÁÿ ÁÍ ÍÁËß à ÓÍ
.ËÁàË àË ÅÁÍ ß Ä ÿà Þ Þ ß
áÍàÎÁËÁ ÿËÁß
àé Ë ÿ Þ ÙÍ à ÅÁ ÝÎ Ýÿ Í Graphics_2D Ð à
ÿßÍ Üéé ÿàÔ à Ë ÿ ÍË .ÝÁË ÁÍ àË ØÍ ÿ ß
1024x768 ÅéË ÍË Ü ±°°x±°° Í Ú àÎÁËÁ .ËÍÁË ÍßÍ Íß à
.Ëßé ËéÁß Åß Ëßÿ render ±¶°°x±²°° ÅË ÿÁßË ÿÁÍ à ÿ ß
áÍé é ÿ ÈÁ Í ÍË ÝßË ÐÁßË ÁÍÎ ¬ÅÁ ÞßÍ Í Ý ÞÀ Å
.ËÍ ËÁß ÍÕ à Í ß Í à ÍË ß ËËÿ Þ ÁÍ
ÿéËéÁß ËÍßé ÍË àé ËéËÿé àÎéÁ é à ÍÍ ÿ ¬ÍË ÅÍ à
ÿéé Úé é à .Ý Í à Ë Åß à àß ÞßË áÍàÎÁËÁ
¬Ëÿ à (à àË Ä) ÍÕ ËÍß à Ë ÿÁÍ ÁÍ Graphics_2D
¬àËé ØÍ ÿ ÍË .ËÁË ËÁß Í ÐÁßË ÐÁ Í ÁÍ ÍÕ ËÍß ÿ
Üé àÍÍË ÞËÍ Í ÿ .Ë ËÁß ÝÕ ÈÁ Í ÍË àÔ ·² ÓÍ Ñ
ËéÁß ·² ÈéÁ Ú ÍË Ú Í Ú .Ë áÍÝ ËÁß Ýß Ë
ÎÁ àé .ÅÁ àÔ ·¹² ÍË ¶±² (ÈÁ ±± ÍË ž/µ) ÿÁà à Ú .ÅÁ
ÍË éé Ý ÁÍÎ Ë Í ËÁß Ë ¬Ëÿ àË Á Ä API
.Ë àË ØÍ ÿ
Áß Ä Ý
.ÅÁ àË ÝËÁ àß Ü Í àÍ ßË ÍË Áß Ä Ý
àËéé éÁ Java2D API ÎÁ àé ËéËÿ àÎÁ à Ä Ý 1.2 à ÎÁ
à ÞÎ ÞÁ ÎÁ ÿ ÞÁß Graphical API ÞÍ à Í ÎÁ ÿ .Ë
ÿßÍ à áÎ Í ËÁË ËÁß àÎÁ 2D API ÞÁ .Ëÿ render ÁÍ à à àË
áÍ Í ÎÁ Îß Ä API à ÍÁ .Ëß àËÍßÀ Ý Ì ÿßÍ Ëßÿ àË à
Ãéé éÁ ÿééÎ Íé ÍË ÍéÍ Í Ôß Í Ü ÍË à Ëÿ àË Á
àË Á Í ß ÿßÍ Å ß Å à Å Í Í Ëß ÎÁ Áß ¬ËËÍÿ
ÎÁ àËé Á Ý ÍË .Ëÿ ÿÁà ÿ Ëßß ÿÍ Í .Ëÿ
ÍÁ Ô ¬ËÍÁË Ëßß àÍ Í Í Å ÞËÍßÀ ÅË ÿÁÍ ÿÁÍ È API
ÞÁ .Ë Ã Á ÁÍ Í Í Ú ËÁß ÿ ÍÍ ¬Ëß ÍÁËß ÅÍ ÛßÁË
ÍË Internet Printing Protocol Þé éÁË é Þé à ÅÁ ÿÁà Å ÿ
Áßé ÍË Äé ÜËé .Ëß ËÁß Æ Ü ÞÀ àÍÍË 1.4 Áß áË à
éÁ àéé à Í ÞÍ Áß ÿ à ÍË .ÅÁ àËß Í 1.2
áËéÎ ÍÁËéé àé ÿß à Ú Ä 1.1 Áß ÍË Ü ÿÁÍ .Ëß Ò
ß ÅéÍ ÍÕ ÍÎ ÁÍ Í ÞÍ 1.2 Áß .Ëß Ë Í ß ÅÁË Î àÕ
Ëÿ CallBack ÜË ÐÁ Í àË ÿÁÍÔ àÍßË API ÞÁ .ÅÁËÁ Í ÁÍÀ
àééé Üé ÍË à à ß àÍ à ÅÁ Ä ÿÍ Ý Ú à
àé Åéé ÅÁ ÿ Í Å ÍË ÜË ÞÁ .Ëÿ ÜÍ ÁÍÀ ¬ÅÁ
àËéé Í ÁÍ Ä àÕß àÍ Ü ÞÁ ÍË à JDK 1.1 ÍË àË àË Á ÜË
áËÁËÍÁÍé àÍ à Ýìß ÅÍß ÞÁ à Ýß ÞËÍ àË ÿÁÍ .ËÍÁË
Ý .Ë à Þ ÞÎ Ú ÍË ÁÍ à à ËÍÁË Ä ÿÍ ÿÝ
Ëé à ÁË Î Í Ú ÎÁ Í ÞÁ ÍËÍ Ú à ÅÁ Þ Ä ÿÍ
.ÅÁ áÍ ÿÁÎ ÿÁÍÁË ÜË ÞÁ .Ë ÍËÍ Åß ÎÁ ÇÍ ÁÍ Å
à .Í Í à à Ü ÜÍÁ ÿ à à à ÅÍß à ÜÍÁ à ÎÁ ÜßÁ
ÿÁàéÕéé à à ÁÍ áÍ àË Å à ËËÿ àÎÁ àÍ à Ã Í ÞÁ
Ëééé àééÍ .Ë Ä ¬ËÍÁË Î Í Ëßß àÕ ÎÁ Í ÿ
à Ú ÍßÔ ËÁË Ë Ô à .Ë Ä ß à à ÁÍ à Í à ËÁË
.Ë render ÁÍ
Þé Ä ÿÍ ÿ ¬Å ÞÁ ÍË .ÅÍ ËÁß àË ÁÍ Í à API
àé ÿéé ÃÔ ÞÁ à Ë render Ø ÅË ÍË ÁÍ à Ú à ÅÁ
Ìé à Ë ÍÁ ÝßË àÍ ÍË .ËÍÁË à Ü Ä ÿÁÍ Î ËÍß ÿÅ
ÞéééÁ à ÅÁ ÝÎ ¬ËË Üß ÐÍ ÁÍ Ì Òß Í Í Ú ÿßÍ
ÍééÕ ÞÀ ÅéÍË Üé output tray ÍË à ¬Ë Ä Ø Å ÍË ÁÍ ÚÍÁË
.Ëß
ÿéÎ Äé ÿéÍé ËÍÁË Ëßéß Áßé ÍË Äé ÜËé ßË Rendeing ÿéßéÁ
(Pageable Jobs) ÿÎ à ÿÍ ß (Printable Jobs)
ÞéÁ ÍË .ÅÁ ÍË ÜË ÎÁ Í À ß Printable Jobs Ä à ÔßÍ ÍßÁ
ÍßéÔé Åééé .Ëßÿ àË Á ÚÍÁË à ÿÁÍ page Printer ÎÁ Ô ÜË
àéé ÞÍÀ à ÿ ß .Ëßÿ ÖßÍ Í à à ËËÍÿ render ÿÁß
Äé ÿéÍé Ýé .ËËÍÍ No_Such_Page à Ë Page Printer Ëßÿ Ä
ÿÁÍ .ËË ÝÁ Ã Í à ÁÍ Å render àÍ à Ëÿ ÅÁßÍË à
Ýé ¬Ëß ÍËÍ · µ à ÎÁ àË ÅÁßÍË ÞÁ ÎÁ ÍÁ ¬Ü
¶ ¬µ àé Ô Á ¬Ëÿ ÁÍ Ý à Å à ÅÁßÍË Ä ÿÍ
ËéË Þ ÁÍ Print Dialog box Ú àÍ ÍÁ .ËÍ ËÁß Ä ÁÍ · ß
ÁÍéÎ ¬Ëé ËéÁßé àËÁË Þ à ÿßÍ Ëß Ä Ë à Å Ü àÍ
.ÝÁË Ü ÎÁ ÜË ÞÁ ÍË ÁÍ ÿ Å ËÁË à ÅÁ ÞÍ
ÎÁ áÍé é ØÔÁ ß ÿÎà ÿÍ (Pageable Jobs) ÿÎà ÿÍ
àé ÁË Ø Ã Ú ËÁß Pageable Jobs ÍË à Í .ËÍÁË Ä ÿÍ
ÎÁ ÿÁàéßééé .Ëßéÿ àË Á ÍË ß Pageable Jobs ÎÁ .Ë
ÚééÁ ÁÍ Book Ð Ú Þ .ËË Þ ÁÍ Ø ÿ ËÁß ÿ à Å
.Ýÿ ßÎ ÿÁÍ
:Ëÿ ÍÎ Å ÿÁÍÁË ÿÎ Í Ú
Í Í Ú ËÁß ÿ Ü ÿÁÍ Ë à ÁË ÁÍ Ëßé Íé Í ËÁß ÿ à Í
ÁÍ ÃÔ ÅÍ à ÍË Í Í Ú ¬Ë Ä ÁÍ àé Ë à Ë à ÁË
.Ë Ä ÁÍ ÚÍÁË Üé àé Ýß Í Í ß Ë Ä
Ú ÍË .Ë ØÍ ÁÍ ÿ ß Ã Ã Í ÍË à Í ÿÁÍ ËÁßÿ
.Ë ÃÍ Ý ÁÍ Landscape ß Portrait Å ËÁß ÿ ÿÎà Í
Äé Åß ÎÁ ÇÍ ÁÍ Å à ËÁß àÍ ÎÁ ÅÁ Þ ÿÍ Ý
ÃéÔ ÞÁ àÍÍË .ËËÍ ØÌ ÅÁ Þ ÝÎ ÅÍß ÍË Å ÎÁ ÿ ß Ë
ÚÍËé ÍË Þ Î ËÍß à à ËÁË Í ËÁß ÿ Þß ¬Ë ÞÁÍ Ë
.Ë ÝÁÍ ß à ¬Ë
.ÅÁ à Ë àËßÍ ËÁË à ËÍÁË áÎ Pageable jobs
Book Ð
ËéË ÿé àÎÁ à Ð ÞÁ .ÅÁ àË àÁ Book ËË Ð 1.2 à ÎÁ
ß Ëßé ÅéÍé ËÁß ÿ à Í .Ë ÝÁÍ ÁÍ ËË Å ÚÍÁË à
Íééé ÚÍÁË à ËË ÁÍ ØÔÁ ÞÁ à ß Ë à ÁË ÁÍ Ëß Í Í
ËééÁ Pageable ÐééÍé ééÁ Book Ðé àÀ ÎÁ .Ë à ÿ
ËéÁß ÿ Ý ¬Å Ð ÞÁ ÍË à ËÍÁË Î ÿÏß à ÿ ß ¬Ë
.ÅÁ Å ÎÁ ÿÁàß Í Ð ÞÁ .Ë ËÁ ÁÍ Þ Ëß Book Ð
Åééé ÞËÍé àÁ ÿÁÍ .Å Book ÿ Ëßÿ ËÁ ÿ ß ÁË Á
àÍéÍË Þé Åéß à) ËÍ Ã Á ÁÍ ÍÎ ÑßÍ ßË ÎÁ ÿ ËÁß ÿ
Ë ÞÁ Í ÁÍ .(ËÍ àß Í ÅÎ ÿÁÍ API Ñ ÍË Class ÞÁ
ÿé Ú ß .Ë ÿ Þ ÁÍ à ÿÎ Å à ÅÁ PageFormat ÿ
ÍéÁ .Ëéééÿé Ü ÁÍ Printable ÐÍ Á à ËÍÁË Ëßß PagePrinter
Íé éÁÍé ÿéËé àé ¬ËééÁËÿéé Ëßé ÚÍËé ÿßÍ ÁÍ àééé àÍéé
ÍßÔ Ä Ý .Ë ËÍÁß append() Ë ÍË ÁÍ UNKNOWN_NUMBER_OF_PAGES
é Ëééÿé ÁË ÁÍ à àÍ Ã ÍË Å à ÞËÎ ÁË Ú ß Á
.ËÍ NO_SUCH_PAGE ÍÁË à àÁ
é Üéé ÿéé ÍË .Ëßÿ ÝËÁ Ñ ÞÁ ÍË ÞÍ ß áÍßì API Ýß
ÍË .ÝËÍ Å rendering ÿË ß áÍ àÎÁËÁ ÿËÁß ¬à Ü àÍÍË
à Î à ÿ Ý .ËÍ ÝÁß ÍÕ Java Printing API à Ñ ÞÁ
Íéé ß ÐÍ Á à ÎÁ à ËÍÁË ÍÁÍ java.awt.print à ÍË ËÍÁË Ä
àé éé ÿßË ß àËË Þ ÜÌ ÿßË .ËÁàË Ü Ø Ð
.Ëÿ print
| Name | Type | Description |
| Paper | Class | This class defines the page's physical characteristics. |
| PageFormat | Class | PageFormat defines the page's size and orientation. It also defines which Paper to use when rendering a page. |
| PrinterJob | Class | This class manages the print job. Its responsibilities include creating a print job, displaying a print dialog box when necessary, and printing the document. |
| Book | Class | Book represents a document. A Book object acts as a collection of pages. Pages included in the Book can have identical or differing formats and can use different painters. |
| Pageable | Interface | A Pageable implementation represents a set of pages to be printed. The Pageable object returns the total number of pages in the set as well as the PageFormat and Printable for a specified page. The Book class implements this interface. |
| Printable | Interface | A page painter must implement the Printable interface. There is only one method in this interface, print(). |
| PrinterGraphics | Interface | The Graphics object implements this interface. PrinterGraphics provides the getPrinterJob() method to obtain the printer job that instantiated the print process. |
Pageable ÐÍ Á
:ËËÍÿ Ü Ë à ÎÁ Pageable ÐÍ Á
| Method Name | Description |
| int getNumberOfPages() | Returns the number of pages in the document. |
| PageFormat getPageFormat(int pageIndex) | Returns the page's PageFormat as specified by pageIndex. |
| Printable getPrintable(int pageIndex) | Returns the Printable instance responsible for rendering the page specified by pageIndex. |
Printable ÐÍ Á
:ËßÿÜ ÍÁË ßË ß Ë Ú ÎÁ Printable ÐÍ Á
| Name | Type | Description |
| int print(Graphics graphics, PageFormat pageFormat, int pageIndex) | Method | Requests that the graphics handle using the given page format render the specified page. |
| NO_SUCH_PAGE | Value | This is a constant. Return this value to indicate that there are no more pages to print. |
| PAGE_EXISTS | Value | The print() method returns PAGE_EXISTS. It indicates that the page passed as a parameter to print() has been rendered and does exists. |
àéÀ ÎÁ ¬Ë ËÁ ÁÍ Printable ÐÍ Á Ú Ë Í Í à Í
ÞéÀ ÍéÕé à ÿÁà ÿÍ Í ËÁ ¬ÅÁ Ëßß ËÁ ÿÁÍ ÑßÍ Ú Ô
Íé àé Ëéé ÍË Ë Ë à Ë à ÁË Ë Ë à ÍÁ .ËÍÿ
.Ë render Åß ÎÁ ÇÍ ÜÁË ÍË ÁÍ à
ß Ëßéÿé Üéé Îé ÁÍ Graphics à ÅÁ Ëßß print() ÿÁÍ Í ÁÍ à
ÎÁ .ËËÍéÿé àËéé éÁ àéé ÿßÍ ÝÍ ÿÁÍ à Ëÿ ÿ Ð ÿÁÍÁË
¬Ëéééÿé ËééÁ ÁÍ PrinterGraphic ÐéÍ Á Graphics Ð àÀ
ÍéÁ .Ëéÿ instantiate ÁÍ Ä à ËÍßÀ ÅË ÁÍ PrinterJob ËÁß ÿ
ÿé ¬ËÍÁË ÝéÍ à Í ÿÏß ÿ à Î ß ÅÁ àË à ÉÍÔ
ÎÁ Ðé .Ëé ÜË Graphics_2D ÿ à ÁÍ Graphics ÿÍ ÁÍ ËÁß
.Ë ÁË ÿÍ Ë Áß áËßË ÿAPI ÿ à ËÁß ÿ ÞÀ
ËééÁß ÜË Ä Ü Ü Ä Å ÿ à Å à Ë à ÁË àß
.Ë ÁË ÁÍ ÓÍ Ñ ÖßÍ àÔ Ü Ë àÁÍ ³ Ü à .Ë
.Ë àÁÍ Ä Ü Ü ³ Ü à
±x± ÜÔ Ú Ä ÿÁÍ .Ëÿ Í Í à ÿ Å àËË Þ (0,0)
àËé Á ÜÌ ÿË ÁÍ Ä Å à ß Å ÎÁ ÈÁ ± Ë , ÈÁ
.Ë
1: public int print (Graphics graphics, PageFormat pageFormat, int pageIndex) {
2: Graphics2D graphics2D = (Graphics2D) graphics;
3: Rectangle2D.Double rectangle = new Rectangle2D.Double ();
4: rectangle.setRect (pageFormat.getImageableX () + 72,
5: pageFormat.getImageableY () + 72,
6: 72,
7: 72);
8: graphics2D.draw (rectangle);
9: return (PAGE_EXISTS);
}
àééÍé ÁÍ ÜééÔ ÁË ÿ Ë ÍßÔ Ë à Ýÿ ÍË ÿ Ü ÎÁ
ÞéÀ ÿÁÍé .ËËÍé Äé ± Ü Ë Ä à ÿ ÍË ËÁß à Ý
Ü ÁË ÞÁß (0,0) ÎÁ ß Ý àÍ Í ÁÍ Å Ë Ë ÞËß
ÝééÁßé ÜÌ Ñ à Ü àß Ü Í ß ÉÁ .Ý àË Á Ä
.ËÍ
1: public int print (Graphics graphics, PageFormat pageFormat, int pageIndex) {
2: Graphics2D graphics2D = (Graphics2D) graphics;
3: graphics2D.translate (pageFormat.getImageableX (), pageFormat.getImageableY ());
4: Rectangle2D.Double rectangle = new Rectangle2D.Double ();
5: rectangle.setRect (72, 72, 72, 72);
6: graphics2D.draw (rectangle);
7: return (PAGE_EXISTS);
8: }
Ý àÍ ÁÍ Å ÝÁß ÿ ³ Ô ÍË translate() Ë ÎÁ àË Á
Ëé à àÔ ÞÁ ÎÁ .Ý ÝÕ Ä Ü ÿ ÍË ÁÍ (0,0) ÁË àÔ ß
.ËËÍ ËÁß ÞÀ ß Í Ë
PrinterGraphics ÐÍ Á
:ËËÍÿ Ü Ë Ú ÎÁ PrinterGraphics ÐÍ Á
| Method name | Description |
| PrinterJob getPrinterJob() | Returns the PrinterJob for this rendering request and is implemented by the Graphics class |
Paper Ð
:ËËÍÿ Ü Ë Å ÎÁ Paper Ð
| Method name | Description |
| double getHeight() | This method returns the page's physical height in points (1 inch = 72 points). For example, if you are printing on a letter-size page, the return value will be 792 points, or 11 inches. |
| double getImageableHeight() | This method returns the page's imageable height. The imageable height is the height of the print area that you may draw on. See Figure 1 for a graphical view of the imageable area. |
| double getImageableWidth() | This method returns a page's imageable width (the width of the print area that you may draw on). See Figure 1 for a graphical view of the imageable area. |
| double getImageableX() | This method returns the x origin of the imageable area. Since there is no support for margins, the return value represents the left margin. |
| double getImageableY() | This method returns the y origin of the imageable area. The value returned from this method is equivalent to the top margin. |
| double getWidth() | This method returns the page's physical width in points. If you print on a letter-size paper, the width is 8.5 inches, or 612 points. |
| void setImageableArea(double x, double y, double width, double height) | This method sets the imageable area and specifies the margins on the page. Actually, the API provides no method to set the margins explicitly; you have to calculate them yourself.
|
| void setSize(double width, double height) | This method sets the physical page size. To define an 8.5-by-11-inch sheet, you would supply 612 and 792 points. Note that the default size is LETTER. |
Paper Ðé àé Ëééé àé ÁË ÍÔ ÝßÍ áË Å ×ÁÍ àÁ ÎÁ Ü
ÿéé àËÍÁË Í ÍË PageFormat Ð .Ëÿ ØÍ ÁÍ Ì ÿÎ Å
Ðé ÞÁ à .Ëÿ Ì Öß ß àÎÁËÁ ¬Ì Å Ë Ì ÿÏß
.Ëßéÿé àËÁË Íß Printable ÐÍ Á ÍË print() Ë à áÍ ÁÍ ÅÍß
Ãéé ÍË Ìéé Åéé ß àÎÁËÁ ¬Ä Ü ÿ ÞËÍßÀ ÅË Å Paper ÎÁ
.Ëßÿ àË Á ÐÍ
PageFormat Ð
:ËËÍÿ Ü Ë ±² ÎÁ PageFormat Ð
| Method name | Description |
| double getHeight() | This method returns the page's physical height in points (1 inch = 72 points). If your page measures 8.5 by 11 inches, then the return value will be 792 points, or 11 inches. |
| double getImageableHeight() | This method returns the page's imageable height, which is the height of the print area on which you may draw. See Figure 1 for a graphical view of the imageable area. |
| double getImageableWidth() | This method returns the page's imageable width -- the width of the print area on which you may draw. Figure 1 illustrates a graphical view of the imageable area. |
| double getImageableX() | This method returns the x origin of the imageable area. |
| double getImageableY() | This method returns the imageable area's y origin. |
| double getWidth() | This method returns the page's physical width in points. If you print on letter-sized paper, the width is 8.5 inches, or 612 points. |
| double getHeight() | This method returns the page's physical height in points. For example, letter-sized paper is 11 inches in height, or 792 points. |
| double[] getMatrix() | This method returns a transformation matrix that translates user space into the requested page orientation. The return value is in the format required by the AffineTransform constructor. |
| int getOrientation() | This method returns the orientation of the page as either PORTRAIT or LANDSCAPE. |
| void setOrientation(int orientation) | This method sets the orientation of the page, using the constants PORTRAIT and LANDSCAPE. |
| Paper getPaper() | This method returns the Paper object associated with the page format. Refer to the previous section for a description of the Paper class. |
| void setPaper(Paper paper) | This method sets the Paper object that will be used by the PageFormat class. PageFormat must have access to the physical page characteristics to complete this task. |
PrinterJob Ð
Ýé Üé Þ ÍË ËÁß ÿ ß Ë ÿ ÜÍ ÁÍ Ä Í ÞÍ PrinterJob Ð
Ü ÍßÔ Ð ÞÁ Å ÜÌ ÍË .Ë áÎ ß ÜÍ ÁÍ PrinterJob Ú
.ÅÁ àË ÍÌ
| Method name | Description |
| abstract void cancel() | This method cancels the current print job. You can validate the cancellation with the isCancel() method. |
| abstract boolean isCancelled() | This method returns true if the job is cancelled. |
| PageFormat defaultPage() | This method returns the default page format for the PrinterJob. |
| abstract PageFormat defaultPage(PageFormat page) | This method clones the PageFormat passed in parameters and modifies the clone to create the default PageFormat. |
| abstract int getCopies() | This method returns the number of copies that the print job will print. |
| abstract void setCopies(int copies) | This method sets the number of copies that the job will print. Note that if you show a print dialog box, users can alter the number of copies (see the pageDialog method). |
| abstract String getJobName() | This method returns the job name. |
| static PrinterJob getPrinterJob() | This method creates and returns a new PrinterJob. |
| abstract String getUserName() | This method returns the user name associated with the print job. |
| abstract PageFormat pageDialog(PageFormat page) | This method displays a dialog that allows the user to modify the PageFormat. The PageFormat, passed in parameters, sets the fields of the dialog. If the user cancels the dialog, then the original PageFormat will be returned. But if the user accepts the parameters, then a new PageFormat will be created and returned. Since it will not show the same parameters on all operating systems, you must be careful when using the pageDialog. |
| abstract void setPageable(Pageable document) | This method queries the document to obtain the total number of pages. The Pageable will also return the PageFormat and the Printable object for each page. See the definition of the Pageable interface for more information. |
| abstract void setPrintable(Printable painter) | This method sets the Painter object that will render the pages to be printed. A Painter object is an object that implements the Printable class and its print() method. |
| abstract void setPrintable(Printable painter, PageFormat format) | This method completes the same tasks as abstract void setPrintable(Printable painter), except that you supply the PageFormat that the Painter will use. As indicated in the definition of the Printable interface, the print() method passes a PageFormat object as the first parameter. |
| abstract void print() | This method prints the document. It actually calls the print() method of the Painter previously assigned to this print job. |
| abstract void setJobName(String jobName) | This method sets the name of the print job. |
| abstract boolean printDialog() | This method displays a print dialog box that allows the user to change the print parameters. Note that this interaction's result will not be returned to your program. Instead, it will be passed to the peer operating system. |
| abstract PageFormat validatePage(PageFormat page) | This method will validate the PageFormat passed in parameters. If the printer cannot use the PageFormat that you supplied, then a new one that conforms to the printer will be returned. |
Book Ð
:ËËÿ Ü ÁÍ Book Ð Ë Å
| Method name | Description |
| void append(Printable painter, PageFormat page) | This method appends a page to the Book. The painter and the PageFormat for that page are passed in parameters. |
| void append(Printable painter, PageFormat page, int numPages) | This method completes the same tasks as void append(Printable painter, PageFormat page), except that you specify the number of pages. |
| int getNumberOfPages() | This method returns the number of pages currently in the Book. |
| PageFormat getPageFormat(int pageIndex) | This method returns the PageFormat object for a given page. |
| Printable getPrintable(int pageIndex) | This method returns the painter for a given page. |
| void setPage(int pageIndex, Printable painter, PageFormat page) | This method sets the painter and the PageFormat for a given page already in the book. |
Ä ÿÁÍß Ë
ËééÁ PrintJob ÿéé Ú ÁË Á ÍË .ÅÁ ÞÀ Í Ä ÿÁÍ ÜÁÍß Ë
.Ë
PrinterJob printJob=PrinterJob.getPrinterJob();
PrinterJob à printer ÿ PrinterJob ÎÁ setPrintable() Ë ÎÁ àËé Á Ðàé ÅéÁ ÿéé Þé printer ÿ Ú à Ë à ÁË àß .Ë (assign) ÙÔÁ
.ËÎÿ ÁÍ Printable ÐÍ Á
printJob.setPrintable(Painter);
.ËÍ ÝÕ Painter ÁÍ PageFormat ËÁß ÿ àÁ
printJob.setPrintable(Painter, pageFormat);
.Ë ËÁ ÁÍ print() Ë Ë Painter ÿ ÝÁÍ ß
public int print(Graphics g, PageFormat pageFormat int page)
ÞËÍé render ÿÁÍ ÞÀ ÎÁ à ÅÁ graphics handle Í ÁÍ Þ Á ÍË
áÍé Åé ÿÁÍ ÞÀ ÎÁ à ÅÁ ÿ Í pageFormat .Ëÿ àË Á à
ÞéÁ .Ëßé render Ë à ÅÁ à àÍ ÿ Í ÁÍ ß Ëßÿ àË Á
.ÅÍÿ ÍÁÍ àË Á ËÍß ÞÀ Ä Ú ÿÁÍ Ë à Ëß áÍßÁ à
ÿÁÍ àß ÞÁ ÍË à ÿ ÃßÍ Í ÿÁ ÃßÍ Í ÿÁ àË
áÍé ØÔÁ ß Ëß ËÁß Ü Java Printing API ÎÁ ÝËÍßÀ Ëßß
àé ÞÀ Íé ß ÃÍ .ËÁË ËÁß Þ Ø ÿßÍ Ëß ËÍß ÍË ÁÍ
ÎÁ àË Á Þ .Ë ËÁ ÿ Á ß Å ¬ÚÍÁË à ËË ÿ àÎÁ
àé ÁÍ Åé à ÍË ÁÍ ÿ Á ÅÍ à ÅÁß ËÁß ¬ÃÍ ÞÁ
ÿéAPI ÎÁ ÍÁ .Ë àÁ ÞÀ ÎÁ à Ú à ¬Ëÿ àÁ ÿÁàËßÍ
àé ÁÍ export ÿéééÏéß ÿé éÁÍ àé ËéÁß ÿ ¬Ëÿ àË Á Ä
Íé ééÍé àé ééé àÁ ¬Ë àÁ HTML PDF ÿàËßÍ
àËé Äé ÚÍÁËé àéé ÜÁÍ ÞËÍ ÞÀ ÃßÍ ¬ÿÁ ØË Á .Ë Í
à Ú Ô ¬Ëÿ àË Á Ä ÿAPI ÎÁ Ä Ý ÍË ÿ ß .Ëÿ
¬ééÁÍÁÍ Ý Þ .Ë ËÁß ßÍßÍ ¬ÞÀ ÿßÍ ÝÍ ÿÁÍ ÚÁÍ
ÁÍéÎ ¬ËÍÁË Ëßß ¬headers/footers ßË ¬ÁÍ ¬Í ¬Íß
.Ëééé à Þ Ëß ÁÍ Ä Ü àËßË Ö ÍÁ ß ÓÍ (x,y) ÁË Ë
.ËÁË ËÁß Éß ÁÍ Ø Ô ÞÁ ÿ Ä ÃßÍ
áÍ à
¬áÍéé àÎÁËÁ ÿËÁß à .ÝËÁË Éß ÁÍ ÿ Í ÅìÎ Ñ ÞÁ ÍË
ÍéÕé éé ß (Printable ß Pageable) rendering ÿßÁ ßË ¬à ÃÍ
àéé é API Ä àÍË ÉßÍ Í Ú " ß ÝËß ÿÍÍ ß àËÍ
ÎéÍé Í ÝÁ Å ÿ ÞÍ ß Ë ÿßÍ "Í áË Å ÍË .ÝËÁË
ËËéé é ÿéÝÍéé ÍË Ä Ý ÍË à ÿà à .ËÍ ÝÁß
ÎÁ Üééé à ³ Ñ ÍË .Ëß ÝÁß ÿÍÍ ß àËÁ ÍÕ ¬Ýÿ ËÍßÍ
.Ëß ÝÁß Æ ÃßÍ ËÁ ß ÉÍÔ
| àËß ÿÍ |
|
Ü ÍË ÁÍ Infocom ÿß .ÅÁ Áß Íß Ú Jean-Pierre Dube ¬Ëéß Ü à ÅÁ ÿÁà Í ÿàÍ ÿÁÍÁË Infocom .Ëß Ð ±¹¹ž àÍ ÿÁÍÁË Jean-Pierre .Ëÿ ÅÍË Ô ÍË ß Ð ÍËÚÍÁË ÅÍË Ëßé Íé áÍ ÞÁ ÿß .Ëÿ Áß ß C ¬Visual basic ÍË ÿÁàËÍ ß ß .ÅÁ àËß ÁËÁ ¬ÅÌ ÍË à ÞÁ Þ ß Ý ÍË à ÑÍË à ÁÍ |
"Printing in Java," Jean-Pierre Dubé (JavaWorld) 