16.10 Drucken

Zum Drucken von Inhalten gibt es zwei unterschiedliche Ansätze, da sich die Druck-API 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 nativen, schwergewichtigen 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.

16.10.1 Drucken der Inhalte

Der Druckvorgang beginnt mit einem Objekt java.awt.print.PrinterJob, was die Fabrikfunktion getPrinterJob() erfragt. Dann kann über setJobName(String) ein Name vergeben und über setCopies(int) die Anzahl der Kopien festgesetzt werden.

Seitenbeschreibung durch Printable

Viel wichtiger ist jedoch, dass dem PrinterJob mit setPrintable() ein Printable übergeben wird, das die Darstellung der Seite übernimmt.

Listing 16.26 com/tutego/insel/ui/print/PrintStuff.java, TextPrintable

static class TextPrintable implements Printable 
{ 
  static Font font = new Font( Font.SANS_SERIF, Font.PLAIN, 20 ); 
 
  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() 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 drawLine(), drawString() 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’s print() von PrinterJob

Zwei Funktionen von PrinterJob sind spannend:

• Die Methode print() startet direkt mit dem Drucken.

• printDialog() öffnet einen Drucker-Dialog, und die Methode liefert true, wenn der Benutzer einen Ausdruck wünscht.

Wir wollen in einem Beispiel einen Druckerdialog anzeigen und abhängig davon mit print() fortfahren oder die Methode beenden.

Listing 16.27 com/tutego/insel/ui/print/PrintStuff.java, main()

PrinterJob pjob = PrinterJob.getPrinterJob(); 
 
if ( pjob.printDialog() == false ) 
  return; 
 
job.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 erzwang.

abstract class java.awt.print.PrinterJob

• abstract void cancel() Bricht das Drucken ab.

• abstract void print() Druckt die Seiten.

• abstract void setPrintable( Printable painter ) Setzt das Printable, das die Seite beschreibt.

interface java.awt.print.Printable

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

16.10.2 Bekannte Drucker

Die im System bekannten Drucker sind in der Zentrale PrintService angemeldet. Dort lassen sie sich auch erfragen:

for ( PrintService s : PrintServiceLookup.lookupPrintServices( null, null ) ) 
  System.out.println( s.getName() );

Auf meinem System gibt es zum Beispiel die Ausgabe:

pdfFactory Pro 
ImageMaker Color Driver 
FinePrint 
Brother HL-1850/1870N series 
Adobe PDF

Ihr Kommentar