PrintCopies Propriedade

PDFs podem carregar uma preferência de impressão consultiva recomendando quantas cópias o diálogo de impressão deve pré-preencher. Essa preferência reside no catálogo sob /ViewerPreferences /NumCopies (PDF 32000-1 § 12.2 Table 150) PrintCopies expõe o valor decodificado: um inteiro positivo quando presente, ou 0 se o PDF deixar o campo indefinido (nesse caso as implementações devem tratá-lo como 1)

Isso é puramente uma dica embutida no arquivo pelo autor; não tem efeito sobre a renderização do PDFium e não influencia como o documento é rasterizado. Para realmente imprimir várias cópias, sua aplicação ainda precisa passar a contagem para sua camada de impressão (Windows GDI StartDoc, um componente de impressão de terceiros etc.)

As propriedades companheiras PrintScaling, PrintPaperHandling e PrintPageRanges expõem as outras dicas de impressão das preferências do visualizador no mesmo dicionário, para que você possa encaminhá-las todas para um diálogo de impressão de uma vez. Use ViewerPreference['NumCopies'] para a forma de string bruta, se necessário

• O intervalo legal por especificação é ≥ 1; PrintCopies = 0 significa "preferência não presente no documento"
• Ler o valor é O(1) — o PDFium analisa o catálogo sob demanda, portanto a busca no dicionário é amortizada ao longo da vida do documento
• Honrar essa dica é opcional. A maioria dos visualizadores de desktop (Acrobat, Edge, Foxit) a expõe como a contagem padrão de cópias em seu diálogo de impressão, mas permite que o usuário a altere
• O componente PDFium Delphi Component não executa a impressão real; combine o valor com Printer da VCL ou qualquer outra API de impressão