PrintPageRanges プロパティ

この API エントリでは識別子、シグネチャ、コードブロック、PDF 用語を元の表記のまま保持します。

PDF の作成者が印刷ダイアログに提案したい 1-based ページ範囲のデコード済みリストです —/PrintPageRange entry of the document's /ViewerPreferences dictionary.

PDF 1.7 added /PrintPageRange to /ViewerPreferencesは、ビューアーが印刷ダイアログで事前選択すべきページ範囲を表す整数ペアの列です (PDF 32000-1 § 12.2 Table 150)。PDFium はその配列を解析し、このプロパティを通じて Pascal 動的配列のTPdfPrintPageRange records, each holding a StartPage and EndPage in one-based numbering.

文書にこのエントリが含まれていない場合、返される配列は空です (Length(Result) = 0) — これは「すべてのページを印刷」として扱います。単一ページが推奨される場合、対応する範囲ではStartPage and EndPage values, e.g. (3, 3) for "page 3 only".

Pair the result with PrintCopies, PrintScaling and PrintPaperHandling印刷ダイアログを接続するときに併用すると、4 つのヒントすべてをユーザーに表示できます。他の印刷設定と同じくこれは助言のみであり、PDFium はレンダリング時に範囲を強制しません

• Page numbers in the array are one-based, 画面上のラベル付けに一致します。API (例:PageNumber) that use zero-based indices.
• Ranges may overlap or appear out of order — reflect them as authored. Sort or merge in user code if required.
• The array is freshly allocated on each property read; cache it locally if you iterate the data more than once.
• この提案に従うかどうかは任意です。Acrobat、Edge、Foxit は印刷ダイアログのページ範囲欄に範囲を表示しますが、ユーザーによる上書きを許可します

PrintCopies, PrintScaling, PrintPaperHandling, ViewerPreference