PDFium Delphi Component Docs

PrintCopies Eigenschaft

Komponente: TPdf  ·  Unit: PDFium
Eingebettete empfohlene Anzahl von Kopien, auf die der Autor des PDFs den Druckdialog standardmäßig setzen möchte — der /NumCopies-Eintrag im /ViewerPreferences-Wörterbuch des Dokuments.

Syntax

property PrintCopies: Integer; // read only

Description

PDFs können eine empfehlende Druckeinstellung tragen, die vorschlägt, wie viele Exemplare der Druckdialog vorbelegen soll. Diese Einstellung liegt im Katalog unter /ViewerPreferences /NumCopies (PDF 32000-1 § 12.2 Table 150) PrintCopies legt den dekodierten Wert offen: eine positive Zahl, wenn vorhanden, oder 0, wenn das PDF das Feld offen lässt (Implementierungen sollten das dann als 1 behandeln)

Das ist rein ein vom Autor in die Datei gebackener Hinweis; er hat keinen Einfluss auf PDFiums Rendering und spielt keine Rolle dafür, wie das Dokument rasterisiert wird. Um tatsächlich mehrere Exemplare zu drucken, muss Ihre Anwendung die Anzahl weiterhin an ihre Druckebene durchreichen (Windows-GDI-StartDoc, eine Drittanbieter-Druckkomponente usw.)

Die Schwester-Eigenschaften PrintScaling, PrintPaperHandling und PrintPageRanges legen die übrigen Viewer-Preferences- Druckhinweise aus demselben Dictionary offen, sodass Sie alle auf einmal in einen Druckdialog routen können. Für die Roh-Zeichenkette ViewerPreference['NumCopies'] verwenden, falls Sie sie brauchen

Remarks

Example

// Pre-fill the spin edit with the document's suggested copies count.
var N: Integer;
begin
  N := Pdf1.PrintCopies;
  if N < 1 then N := 1;
  spinCopies.MinValue := 1;
  spinCopies.MaxValue := 999;
  spinCopies.Value := N;
  Memo1.Lines.Add(Format('PDF suggests %d copies', [N]));
end;

See Also

PrintScaling, PrintPaperHandling, PrintPageRanges, ViewerPreference