Vega.Printers — Drucken

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.

Grundtypen

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.

Papier

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.

Drucker und Seite

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.

Backend-Grenzen

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.