Vega.Printers stellt die plattformunabhängige Druckabstraktion bereit. Eine Anwendung arbeitet mit TPrinter, TPaperSize und TPrinterCanvas; das Backend entscheidet, ob tatsächlich gedruckt werden kann und wohin die Ausgabe geht.
| Typ | Zweck |
|---|---|
TPrinter | Drucker auswählen, Dokument- und Seitengrenzen verwalten, Seiten beginnen/beenden und Ausgabe schreiben |
TPaperSize | Standardpapier oder benutzerdefinierte Breite/Höhe verwalten |
TPaperRect | physische Papierfläche und nutzbare Arbeitsfläche |
TPrinterCanvas | TCanvas für eine Druckseite mit DPI, Rändern und Seitennummer |
TPostScriptWriter | interner Writer für dateibasierte bzw. rohe Druckausgabe |
Die Einheiten werden in Punkten beschrieben; VEGA_POINTS_PER_INCH ist 72. Die Standardauflösung des Druckers ist VEGA_DEFAULT_DPI (150), wenn das Backend keine eigene Auflösung meldet.
var paper: TPaperSize := NewPaperSize();
paper.SetPaperName("A4");
var w: int64 := paper.Width();
var h: int64 := paper.Height();
var rect: TPaperRect := paper.PaperRect();
SetPaperName liefert false, wenn das Papier unbekannt ist. Für Sonderformate steht SetCustomSize(width, height) bereit. Die freien Funktionen PaperNameAt, PaperWidthAt, PaperHeightAt und PaperIndexOfName erlauben die Aufzählung der Standardformate.
var p: TPrinter := NewPrinter(backend);
if (p.CanPrint()) {
p.SetTitle("Bericht");
p.PaperSize.SetPaperName("A4");
if (p.BeginDoc()) {
if (p.BeginPage()) {
p.Canvas.SetTitle("Seite 1");
p.Canvas.ClearPage();
p.Canvas.TextOut(72, 72, "Hallo Druckwelt");
p.EndPage();
}
p.EndDoc();
}
}
Für mehrere Seiten wird NewPage zwischen EndPage und BeginPage verwendet. Abort bricht einen laufenden Druck ab. Write und WriteText sind für rohe bzw. textuelle Ausgabe vorgesehen; normalerweise zeichnet man über TPrinterCanvas.
CanPrint() und CanRenderCopies() müssen vor einer UI-Aktion abgefragt werden. Ein Backend darf melden, dass kein Drucker vorhanden ist. LyxOS kann die Ausgabe als Datei bereitstellen, auch wenn kein physischer Spooler vorhanden ist. Die API darf in diesem Fall keinen Drucker vortäuschen.
Die drei Druckdialoge stehen in Vega.PrintDlgs.
Letzte Aktualisierung: 2026-11-09 — neu für Vega 0.6.0.