11.8Drucken *
Zum Drucken von Inhalten gibt es zwei unterschiedliche Ansätze, da sich die Druck-API beim Übergang von Java 1.1 auf Java 1.2 geändert hat:
In der Version für Java 1.1 steht die (abstrakte) Klasse PrintJob im Mittelpunkt. Sie liefert mit getGraphics() den Grafikkontext, über den sich zeichnen lässt. Hier gibt es einen Unterschied zwischen einer leichtgewichtigen Swing-Komponente und den harten, schwergewichtigen nativen AWT-Elementen.
Java 1.2 druckt Seiten über Printable-Objekte nach dem Callback-Prinzip und behandelt selbst gezeichnete und leichtgewichtige Komponenten gleich. Wir wollen uns nur mit dieser Variante beschäftigen.
11.8.1Drucken der Inhalte
Der Druckvorgang beginnt mit einem Objekt java.awt.print.PrinterJob, das die Fabrikmethode getPrinterJob() erfragt. Dann kann über setJobName(String) ein Name vergeben und über setCopies(int) die Anzahl der Kopien festgelegt werden.
Seitenbeschreibung durch Printable
Viel wichtiger ist jedoch, dass dem PrinterJob mit setPrintable(Printable[, PageFormat]) ein Objekt übergeben wird, das die Darstellung der Seite übernimmt:
Listing 11.18com/tutego/insel/ui/print/PrintStuff.java, TextPrintable
static Font FONT = new Font( Font.SANS_SERIF, Font.PLAIN, 20 );
@Override
public int print( Graphics g, PageFormat pageFormat, int pageIndex ) {
if ( pageIndex >= 2 )
return Printable.NO_SUCH_PAGE;
g.setFont( FONT );
g.drawString( "Hallo auf Seite " + pageIndex, 100, 100 );
return Printable.PAGE_EXISTS;
}
}
Die Schnittstelle java.awt.print.Printable schreibt eine einzige Operation print(Graphics, PageFormat, int) vor. Das Drucksystem ruft später die Methode auf und übergibt ein Graphics sowie das Seitenformat und die aktuelle Seitennummer. In einer Implementierung dieser Methode bringen wir das auf den Drucker, was vorher auf den Bildschirm kam. Es lassen sich die bekannten Methoden wie drawXXX(…) nutzen. Bei Zeichensätzen ist Vorsicht geboten, weil kein Standardzeichensatz eingestellt ist. Die print(…)-Methode liefert Printable.PAGE_EXISTS bei einer gezeichneten Seite zurück und Printable.NO_SUCH_PAGE, wenn es die Seite nicht gibt.
Drucken über das print() von PrinterJob
Zwei Methoden von PrinterJob sind spannend:
Die Methode print() startet direkt mit dem Drucken.
printDialog() öffnet einen Druck-Dialog, und die Methode liefert true, wenn der Benutzer einen Ausdruck wünscht.
Wir wollen in einem Beispiel einen Druck-Dialog anzeigen und abhängig davon mit print() fortfahren oder die Methode beenden:
Listing 11.19com/tutego/insel/ui/print/PrintStuff.java, main()
if ( pjob.printDialog() == false )
return;
pjob.setPrintable( new TextPrintable() );
pjob.print();
Das print() vom PrinterJob startet den Druckvorgang, was zur Folge hat, dass vom Printable-Objekt die Callback-Methode print(…) so lange für jede Seite aufgerufen wird, bis das Dokument komplett gedruckt wurde oder cancel() vom PrinterJob einen Abbruch erzwungen hat.
abstract void print()
Druckt die Seiten.abstract void setPrintable(Printable painter)
Setzt das Printable, das die Seite beschreibt.abstract void cancel()
Bricht das Drucken ab.
static final int PAGE_EXISTS, NO_SUCH_PAGE
Konstanten für die Rückgabe von print().int print(Graphics graphics, PageFormat pageFormat, int pageIndex)
Callback-Methode, die der PrinterJob für jede Seite pageIndex aufruft.
Abbildung 11.21Die Schnittstelle Printable und die abstrakte Klasse PrintJob
11.8.2Bekannte Drucker
Die im System bekannten Drucker sind in der Zentrale PrintService angemeldet. Dort lassen sie sich auch erfragen:
System.out.println( s.getName() );
Auf meinem System gibt es zum Beispiel die Ausgabe:
ImageMaker Color Driver
FinePrint
Brother HL-1850/1870N series
Adobe PDF