PrintCopies property

Embedded suggested number of copies the PDF's author would like the print dialog to default to — the /NumCopies entry of the document's /ViewerPreferences dictionary.

PDFs may carry an advisory print preference recommending how many copies the print dialog should pre-populate. That preference lives in the catalog under /ViewerPreferences /NumCopies (PDF 32000-1 § 12.2 Table 150). PrintCopies exposes the decoded value: a positive integer when present, or 0 if the PDF leaves the field unset (in which case implementations should treat it as 1).

This is purely a hint baked into the file by the author; it has no effect on PDFium's rendering and does not influence how the document is rasterised. To actually print multiple copies your application still has to pass the count to its printing layer (Windows GDI StartDoc, a third-party print component, etc.).

The companion properties PrintScaling, PrintPaperHandling and PrintPageRanges expose the other viewer-preferences print hints in the same dictionary, so you can route them all into a print dialog at once. Use ViewerPreference['NumCopies'] for the raw string form if you need it.

• The legal range per spec is ≥ 1; PrintCopies = 0 means "preference not present in the document".
• Reading the value is O(1) — PDFium parses the catalog lazily, so the dictionary lookup is amortised across the document's lifetime.
• Honouring this hint is optional. Most desktop viewers (Acrobat, Edge, Foxit) expose it as the default copy count in their Print dialog but allow the user to change it.
• The PDFiumVCL component does not perform the actual printing; combine the value with VCL Printer or any other printing API.

PrintScaling, PrintPaperHandling, PrintPageRanges, ViewerPreference