18.5 Die Steuerelemente zum Drucken

Mit PrintDocument, PageSettings und PrinterSettings kennen Sie nun die wichtigsten Klassen, die im Zusammenhang mit dem Drucken stehen. Darüber hinaus werden in der Toolbox von Visual Studio 2008 auch insgesamt fünf Steuerelemente angeboten, die uns mit ihren Fähigkeiten teilweise erheblich die Programmierung erleichtern. Ich möchte Ihnen diese Controls nun vorstellen.

18.5.1 Das »PrintDocument«-Steuerelement

Dieses Steuerelement, das einen Druckjob beschreibt, gehört zu der Gruppe der Steuerelemente, die zur Laufzeit nicht sichtbar sind und deshalb im Komponentenfach einer Form abgelegt werden. Im Eigenschaftsfenster können Sie nur die Eigenschaft DocumentName einstellen. Zur Erinnerung: Das ist der Name des Dokuments, der in einem Meldungsfenster angezeigt wird, sobald der Druckjob mit der Print-Methode gestartet wird.

18.5.2 Das »PrintDialog«-Steuerelement

PrintDialog gehört zu der Gruppe der Standarddialoge. In Kapitel 17 haben wir uns schon mit den Dialogen OpenFileDialog, SaveFileDialog usw. befasst. PrintDialog ist das letzte zu dieser Gruppe gehörende Steuerelement und ist aus der Klasse System.Windows.Forms.CommonDialog abgeleitet. Es ermöglicht dem Anwender die Auswahl eines Druckers und die Festlegung der Anzahl der Ausdrucke sowie des Druckbereichs (siehe Abbildung 18.2).

Abbildung 18.2 Das Dialogfenster »PrintDialog«

Der Dialog wird aufgerufen, um einen Druckjob zu starten. Deshalb ist es auch notwendig, der Eigenschaft Document die Referenz auf den Druckauftrag zuzuweisen, der vom PrintDocument-Objekt beschrieben wird. Das können Sie sowohl im Programmcode als auch im Eigenschaftsfenster einstellen. Vergessen Sie die Zuweisung, wird eine Ausnahme ausgelöst, weil der Dialog zu seiner Anzeige die Angabe eines Druckers benötigt, der aus der PrinterSettings-Eigenschaft des PrintDocument-Objekts bezogen wird.

Im Eigenschaftsfenster werden neben Document noch weitere Eigenschaftseinstellungen ermöglicht. Diese können Sie Tabelle 18.8 entnehmen.

Wir wollen uns das Zusammenspiel des PrintDocument- und des PrintDialog-Objekts nun an einem Codefragment ansehen. Die Methode sei der Ereignishandler des Menüpunkts Drucken. Aufgerufen wird der Dialog mit der Methode ShowDialog. Bekanntermaßen liefert diese Methode einen Rückgabewert aus der Enumeration DialogResult. Dieser entscheidet darüber, ob der Anwender die vorgenommenen Einstellungen übernehmen möchte oder nicht.

private void mnuDrucken_Click(object sender, EventArgs e) { 
  printDialog1.Document = printDocument1; 
  if(printDialog1.ShowDialog() == DialogResult.OK) 
    printDocument1.Print(); 
}

18.5.3 Das »PageSetupDialog«-Steuerelement

Das PageSetupDialog-Steuerelement erlaubt es, die Seitenränder festzulegen, das Papierformat und die Papierquelle anzugeben sowie die Ausrichtung im Hoch- bzw. Querformat zur Laufzeit einzustellen. Dieser Dialog wird üblicherweise über den Menüpunkt Seite einrichten angezeigt.

Abbildung 18.3 Der Dialog »Seite einrichten«

PageSetupDialog bezieht Einstellungen des PageSettings- und PrinterSettings-Objekts aus dem PrintDocument-Objekt, das ebenfalls der Eigenschaft Document übergeben werden muss. Neben dieser Eigenschaft werden weitere Eigenschaften im Eigenschaftsfenster angezeigt und können dort oder im Programmcode die Anzeigeoptionen beeinflussen.

Änderungen, die an den Einstellungen vorgenommen werden, wirken sich auf das PageSettings-Objekt aus.

Etwas unglücklich ist im Dialog die Handhabung der Einstellung der Ränder gelöst. In Abbildung 18.3 können Sie sehen, dass die Beschriftung suggeriert, es handle sich bei den Einstellungen und der Anzeige links, rechts, oben und unten um Angaben in Millimeter. Das ist nur teilweise richtig. Wenn Sie Änderungen vornehmen, den Dialog mit OK schließen und ihn danach erneut öffnen, haben sich die Einträge geändert. Die Einträge, auch wenn Sie sie nicht geändert haben, werden als Millimeterangaben interpretiert und per Vorgabe in Zoll umgerechnet. Nur wenn Sie auf Abbrechen klicken, wird die Umrechnung nicht erfolgen.

In unseren Breitengraden, in denen das metrische System bevorzugt wird, sollten Sie zur Vermeidung dieses Effekts unbedingt die Eigenschaft EnableMetric=true einstellen. Die Umrechnung bei einer Bestätigung mit OK wird dadurch vermieden, und es wird nach dem erneuten Öffnen des Dialogs der gleiche Wert angezeigt. Jetzt handelt es sich wirklich um Millimeterangaben.

18.5.4 Das »PrintPreviewDialog«-Steuerelement

Wollen Sie eine Druckvorschau anbieten? Dann müssen Sie das PrintPreviewDialog-Steuerelement in Ihrer Anwendung einsetzen. Der Anwender kann im Fenster die Größenansicht der Druckausgabe nach vorgegebenen Werten verändern. Handelt es sich um einen mehrseitigen Druckjob, ist die Anzeige von gleichzeitig bis zu vier Druckseiten möglich.

Die Programmierung ist sehr einfach und ähnelt der anderer Steuerelemente. Voraussetzung ist, dass Sie das Steuerelement mit dem PrintDocument-Objekt in der Eigenschaft Document verbinden, damit es sich mit den notwendigen Informationen versorgen kann. Nur eine weitere Eigenschaft wird im Eigenschaftsfenster angeboten: UseAntiAlias. Wenn Sie diese Eigenschaft auf true setzen, werden Schriften geglättet – allerdings ist das gleichzeitig auch mit einer Verschlechterung der Performance verbunden.

Abbildung 18.4 Das »PrintPreviewDialog«-Steuerelement

Das Fenster weist eine Schaltfläche mit einem Druckersymbol auf. Damit diese Schaltfläche das ihr zugedachte Verhalten zeigt, nämlich das Drucken des Dokuments, muss der Rückgabewert der Methode ShowDialog ausgewertet werden:

private void mnuDruckvorschau_Click(object sender, EventArgs e) { 
  printPreviewDialog1.Document = printDocument1; 
  if (printPreviewDialog1.ShowDialog() == DialogResult.OK) 
    printDocument1.Print(); 
}

18.5.5 Das »PrintPreviewControl«-Steuerelement

Während das Steuerelement PrintPreviewDialog im Komponentenfach abgelegt wird, weil es nicht in der Form angezeigt wird, ist das nun vorzustellende Steuerelement PrintPreviewControl ein herkömmliches, das zur Laufzeit der Anwendung für den Anwender sichtbar ist und den Bereich der Seitenvorschau anzeigt. Der Vorteil im Vergleich zu PrintPreviewDialog ist, dass Sie damit eine Seiten- bzw. Druckvorschau nach eigenen Vorstellungen realisieren können, die weit über das hinausgeht, was das Steuerelement PrintPreviewDialog anbietet.

Das Steuerelement ist ein direkter Nachfahre der Klasse Control und erbt die Member dieser Basisklasse. Die meisten werden Sie aber zur Programmierung, die ansonsten denkbar einfach ist, nicht benötigen. Sieben spezifische Eigenschaften zeichnen dieses Steuerelement aus, die wir uns alle ansehen wollen.

Die wichtigste ist die schon bekannte Eigenschaft Document. Solange dieser Eigenschaft kein PrintDocument-Objekt zugewiesen wird, kann das PrintPreviewControl nichts anzeigen.

Ein Dokument kann aus mehr als nur einer Seite bestehen. Diesem Thema werden wir uns später noch eingehend widmen. Wenn mehrere Dokumentseiten im Ansichtsbereich angezeigt werden sollen, müssen Sie in den Eigenschaften Rows und Columns angeben, wie viele Reihen und Spalten gleichzeitig dargestellt werden sollen. Standardmäßig sind beide Eigenschaften auf den Wert 1 eingestellt.

Mit der Eigenschaft Zoom kann die Darstellung einer Seite verkleinert oder vergrößert werden. Die volle Größe eines Dokuments entspricht dem Wert 1.0, der Standardwert ist 0,3. Eine Veränderung des Wertes von Zoom bewirkt, dass die Eigenschaft AutoZoom auf false gesetzt wird. Weist diese Eigenschaft true auf, wird die Seitenvorschau des Dokuments so angepasst, dass es noch im Anzeigebereich des Steuerelements dargestellt werden kann.

Die Eigenschaft StartPage gibt bei mehreren anzuzeigenden Seiten die Nummer der ersten Seite an. Dabei steht 0 für die erste Seite. UseAntiAlias dient wie schon beim PrintPreviewDialog zum Glätten von Schriften.

Das Beispielprogramm »Drucken«

Einen eigenen Dialog zur Seitenvorschau zu programmieren, erfordert nicht besonders viel Programmcode und reduziert sich sogar auf einige wenige Zeilen, wie im folgenden Beispiel zu sehen ist:

...

public partial class Form1 : Form { 
  // allgemeine Zeichenroutine zum Zeichnen in die 
  // PictureBox und zur Druckerausgabe 
  private void DrawGraphic(Graphics g, int x1, int y1, int x2, int y2) { 
  Pen pen = new Pen(Color.Black); 
  for (int i = x1; i <= x2; i += 20) 
    g.DrawLine(pen, x1, y1, i, y2); 
  for (int i = x2; i >= x1; i -= 20) 
    g.DrawLine(pen, x2, y1, i, y2); 
  }

  private void pictureBox1_Paint(object sender, PaintEventArgs e) { 
    this.DrawGraphic(e.Graphics, 0, 0, pictureBox.ClientSize.Width, 
                                pictureBox.ClientSize.Height); 
  }

  private void printDocument1_PrintPage(object sender, PrintPageEventArgs e) { 
    this.DrawGraphic(e.Graphics, e.MarginBounds.X, 
       e.MarginBounds.Y, e.MarginBounds.Width + 
       e.MarginBounds.X, e.MarginBounds.Height + 
       e.MarginBounds.Y); 
  }

  // Menü: Drucken 
  private void mnuDrucken_Click(object sender, EventArgs e) { 
    if (printDialog1.ShowDialog() == DialogResult.OK) 
      printDocument1.Print(); 
  }

  // Menü: Seite einrichten 
  private void mnuSeiteEinrichten_Click(object sender, EventArgs e) { 
    pageSetupDialog1.ShowDialog(); 
  }

  // Menü: Druckvorschau 
  private void mnuDruckvorschau_Click(object sender, EventArgs e) { 
    if (printPreviewDialog1.ShowDialog() == DialogResult.OK) 
      printDocument1.Print(); 
  }

  // Menü: Druckvorschau (erweitert) 
  private void mnuUserDefPrintPreview_Click(object sender, EventArgs e) { 
    Form2 frm = new Form2(); 
    frm.printPreviewControl1.Document = printDocument1; 
    frm.ShowDialog(); 
  } 
}

public partial class Form2 : Form { 
  private void btnGroesser_Click(object sender, EventArgs e) { 
    try 
    { 
      printPreviewControl1.Zoom += 0.05; 
    } 
    catch { } 
  }

  private void btnKleiner_Click(object sender, EventArgs e) { 
    try 
    { 
      printPreviewControl1.Zoom -= 0.05; 
    } 
    catch { } 
  }

  private void btnAuto_Click(object sender, EventArgs e) { 
    printPreviewControl1.AutoZoom = true; 
  } 
}

Abbildung 18.5 Das Hauptfenster des Beispiels »Drucken«

Abbildung 18.6 Der Dialog der erweiterten Druckvorschau

Ihr Kommentar