Seitenleiste
k23:k23.6:k23.6.3:start
Inhaltsverzeichnis
23.6.3 Klasse Printer (gb.form.print)
Diese Klasse ermöglicht es Ihnen, Dokumente auf Druckern auszudrucken oder diese in einer Datei (PDF, PostScript) zu speichern. Diese Klasse Printer (gb.form.print) ist eine Neuimplementierung der Klasse Printer (gb.qt4). Hinzugefügt wurden vier (Margin-)Eigenschaften sowie die Methode Preview().
Die Klasse ist erzeugbar. So erzeugen Sie ein neues Printer-Objekt:
Dim hformPrinter As Printer hformPrinter = New Printer() [ As "EventName" ]
23.6.3.1 Konstanten
Die Klasse Printer (gb.form.print) verfügt über die gleichen Konstanten wie die Klasse Printer (gb.qt4), die im Kapitel 'Klasse Printer (gb.qt4)' beschrieben sind.
23.6.3.2 Eigenschaften
Die Klasse Printer (gb.form.print) verfügt über die gleichen Eigenschaften wie die Klasse Printer (gb.qt4), die im Kapitel 'Klasse Printer (gb.qt4)' beschrieben sind.
Die Neuimplementierung der Klasse Printer (gb.form.print) wurde um 4 Eigenschaften ergänzt:
| Eigenschaft | Datentyp | Beschreibung |
|---|---|---|
| Margin.Top | Integer | Rückgabe oder Festlegung des oberen Seitenrandes in Millimetern. |
| Margin.Right | Integer | Rückgabe oder Festlegung des rechten Seitenrandes in Millimetern. |
| Margin.Bottom | Integer | Rückgabe oder Festlegung des unteren Seitenrandes in Millimetern. |
| Margin.Left | Integer | Rückgabe oder Festlegung des linken Seitenrandes in Millimetern. |
Tabelle 23.6.3.2.1 : Zusätzliche Eigenschaften der Klasse Printer (gb.form.print)
Die Klasse Printer (gb.form.print) verfügt wie die Klasse Printer (gb.qt4) über diese beiden statischen Eigenschaften:
- Default: Gibt den Namen des Standarddruckers zurück.
- List: Liefert die Liste der Drucker zurück.
23.6.3.3 Methoden
Die Klasse Printer (gb.form.print) verfügt über die gleichen Methoden wie die Klasse Printer (gb.qt4). Die Neuimplementierung wurde jedoch um die Methode 'Preview()' ergänzt:
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| Cancel() | - | Bricht den aktuellen Druckauftrag ab. |
| Configure() | Boolean | Öffnet den Dialog zur Druckerkonfiguration. Diese Methode gibt TRUE zurück, wenn der Benutzer den Dialog abgebrochen hat und sonst FALSE. |
| Print() | - | Der Druckvorgang wird gestartet. Während des Prozesses wird eine lokale Ereignisschleife ausgeführt, und die Methode kehrt zurück, wenn der Druckvorgang abgeschlossen ist. Diese Methode gibt TRUE zurück, wenn der Benutzer den Druckvorgang abgebrochen hat oder wenn ein Fehler aufgetreten ist. FALSE wird zurückgegeben, wenn alles in Ordnung war. |
| Preview() | - | Öffnet eine Druckvorschau als modales Formular. |
Tabelle 23.6.3.3.1 : Methoden der Klasse Printer (gb.form.print)
23.6.3.4 Ereignisse
Die Klasse Printer (gb.form.print) verfügt über die gleichen Ereignisse wie die Klasse Printer (gb.qt4).
| Ereignis | Beschreibung |
|---|---|
| Begin() | Dieses Ereignis wird ausgelöst, wenn der Druckvorgang beginnt. |
| End() | Dieses Ereignis wird ausgelöst, wenn der Druckvorgang abgeschlossen ist. |
| Draw() | Dieses Ereignis wird für jede (neue) Seite ausgelöst, die gedruckt werden muss. |
| Paginate | Dieses Ereignis wird ausgelöst, damit Sie Ihr Dokument im Hintergrund paginieren können. Wenn Sie keinen Event-Handler definieren, wird dieses Ereignis nicht ausgelöst. Sie müssen die Eigenschaft Count dann innerhalb des Begin()-Event-Handlers definieren. Ansonsten - wenn Sie dieses Ereignis behandeln - wird der Event-Handler immer wieder aufgerufen, bis Sie die Eigenschaft Count explizit definieren. |
Tabelle 23.6.3.4.1 : Ereignisse der Klasse Printer (gb.form.print)
23.6.3.5 Beispiel
Im folgenden Abschnitt wird Ihnen eine Adaption des Quelltext-Druckprogramms aus der Gambas-IDE vorgestellt. Es verwendet die Margin-Eigenschaft für alle 4 Seitenränder und die Druck-Vorschau. In der Vorschau können Sie noch einige Änderungen am Design und am Layout der Druckseiten vornehmen und anschließend den Text direkt auf dem ausgewählten Drucker ausdrucken oder in eine PDF-Datei drucken.
Abbildung 23.6.3.5.1: Druck-Vorschau
Abbildung 23.6.3.5.2: Text-Editor
Hinweise:
- Im Download-Bereich finden Sie das Quelltext-Archiv für das Beispiel-Projekt.
- Im Projektordner finden Sie im Ordner 'examples' 9 unterschiedliche Text-Dateien, mit denen Sie die das Druck-Programm ausprobieren können.
Download
k23/k23.6/k23.6.3/start.txt · Zuletzt geändert: 31.12.2023 von honsek
Seiten-Werkzeuge
Falls nicht anders bezeichnet, ist der Inhalt dieses Wikis unter der folgenden Lizenz veröffentlicht: CC Attribution-Noncommercial 3.0 Unported
