PDFium Delphi Component Docs

PrintCopies Свойство

Компонент: TPdf  ·  Модуль: PDFium
Встроенное предлагаемое число копий, на которое автор PDF хотел бы по умолчанию настроить диалог печати — запись /NumCopies в словаре /ViewerPreferences документа

Syntax

property PrintCopies: Integer; // read only

Description

PDF может нести рекомендательную настройку печати, предлагающую, сколькими копиями диалог печати должен заполниться по умолчанию. Настройка живёт в каталоге под /ViewerPreferences /NumCopies (PDF 32000-1 § 12.2 Table 150) PrintCopies отдаёт декодированное значение: положительное целое, если запись есть, или 0, если PDF оставил поле незаполненным (тогда реализации должны считать это единицей)

Это чисто подсказка, запечённая в файл автором; на рендеринг PDFium она не влияет и на растеризацию документа не воздействует. Чтобы реально напечатать несколько копий, приложение всё равно передаёт количество своему слою печати (Windows GDI StartDoc, сторонний print-компонент и т.п.)

Соседние свойства PrintScaling, PrintPaperHandling и PrintPageRanges отдают остальные печатные подсказки viewer-preferences из того же словаря, так что все их можно разом отправить в диалог печати. Сырая строковая форма доступна через ViewerPreference['NumCopies']

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