ページプロパティの取得と設定

Aspose.PDF for .NETでは、.NETアプリケーションでPDFファイルのページのプロパティを読み取ったり設定したりすることができます。このセクションでは、PDFファイルのページ数を取得する方法、PDFページのプロパティ（色など）に関する情報を取得する方法、ページプロパティを設定する方法について説明します。例はC#で示されていますが、VB.NETなどの他の.NET言語を使用して同じことを達成することができます。

次のコードスニペットは、Aspose.PDF.Drawingライブラリでも動作します。

PDFファイルのページ数を取得する

ドキュメントを扱う際には、そのページ数を知りたいことがよくあります。Aspose.PDFを使用すると、これはたった2行のコードで済みます。

PDFファイルのページ数を取得するには：

  1. Documentクラスを使用してPDFファイルを開きます。
  2. 次に、DocumentオブジェクトからPageCollectionコレクションのCountプロパティを使用して、ドキュメントの総ページ数を取得します。

次のコードスニペットは、PDFファイルのページ数を取得する方法を示しています。 以下のコードスニペットは、PDFファイルのページ数を取得する方法を示しています。

ドキュメントを保存せずにページ数を取得する

時々私たちはPDFファイルをその場で生成し、PDFファイル作成中に（目次の作成など）システムやストリームにファイルを保存せずにPDFファイルのページ数を取得する必要が出てくるかもしれません。この要件に対応するために、DocumentクラスにProcessParagraphsメソッドが導入されました。ドキュメントを保存せずにページ数を取得する手順を示す次のコードスニペットをご覧ください。

ページのプロパティを取得する

PDFファイルの各ページには、幅、高さ、ブリード、クロップ、トリムボックスなどの多くのプロパティがあります。

ページプロパティの理解：Artbox、BleedBox、CropBox、MediaBox、TrimBox、Rectプロパティの違い

  • メディアボックス: メディアボックスは最大のページボックスです。これは、ドキュメントがPostScriptまたはPDFに印刷されたときに選択されたページサイズ（例えばA4、A5、USレターなど）に対応します。言い換えると、メディアボックスはPDFドキュメントが表示または印刷されるメディアの物理的サイズを決定します。
  • ブリードボックス: ドキュメントにブリードがある場合、PDFにもブリードボックスがあります。ブリードとは、ページの端を超えて広がる色（またはアートワーク）の量です。これは、ドキュメントが印刷され、サイズにカット（「トリミング」）されたときに、インクがページの端まで行くことを保証するために使用されます。ページがトリムマークからわずかにずれてカットされたとしても - ミストリムされたとしても - ページに白い端が現れることはありません。
  • トリムボックス: トリムボックスは、印刷およびトリミング後のドキュメントの最終サイズを示します。
  • トリムボックス: トリムボックスは、印刷およびトリミング後のドキュメントの最終サイズを示します。
  • アートボックス: アートボックスは、ドキュメントのページの実際の内容を囲むボックスです。このページボックスは、他のアプリケーションでPDFドキュメントをインポートする際に使用されます。
  • クロップボックス: クロップボックスは、Adobe AcrobatでPDFドキュメントが表示される「ページ」サイズです。通常のビューでは、Adobe Acrobatでクロップボックスの内容のみが表示されます。 これらのプロパティの詳細な説明については、Adobe.Pdf仕様、特に10.10.1ページ境界を読んでください。
  • Page.Rect: MediaBoxとDropBoxの交差点（一般に見える矩形）。下の画像はこれらのプロパティを示しています。

詳細については、このページをご覧ください。

ページプロパティへのアクセス

Page クラスは、特定のPDFページに関連するすべてのプロパティを提供します。 Page クラスは、特定のPDFページに関連するすべてのプロパティを提供します。

そこから、インデックスを使用して個々のPageオブジェクトにアクセスするか、foreachループを使用してコレクションをループし、すべてのページを取得することができます。個々のページにアクセスすると、そのプロパティを取得できます。以下のコードスニペットは、ページプロパティを取得する方法を示しています。

PDFファイルの特定のページを取得する

Aspose.PDFを使用すると、PDFを個々のページに分割し、それらをPDFファイルとして保存できます。PDFファイルで指定されたページを取得して新しいPDFとして保存する操作は非常に似ています：ソースドキュメントを開き、ページにアクセスし、新しいドキュメントを作成してそのページを追加します。

Document オブジェクトのPageCollectionは、PDFファイルのページを保持しています。 ドキュメント オブジェクトの PageCollection はPDFファイル内のページを保持しています。

  1. Pagesプロパティを使用してページインデックスを指定します。
  2. 新しい ドキュメント オブジェクトを作成します。
  3. 新しい ドキュメント オブジェクトに ページ オブジェクトを追加します。
  4. 保存 メソッドを使用して出力を保存します。

以下のコードスニペットは、PDFファイルから特定のページを取得して新しいファイルとして保存する方法を示しています。

ページの色を決定する

ページ クラスは、PDFドキュメント内の特定のページに関連するプロパティを提供します。これには、ページが使用する色のタイプ - RGB、モノクロ、グレースケール、または未定義 - が含まれます。 Page クラスは、特定の PDF ドキュメントのページに関連するプロパティを提供します。これには、ページが使用する色のタイプ - RGB、白黒、グレースケール、または未定義 - が含まれます。

PDF ファイルのすべてのページは PageCollection コレクションに含まれています。ColorType プロパティは、ページ上の要素の色を指定します。特定の PDF ページの色情報を取得または決定するには、Page オブジェクトの ColorType プロパティを使用します。

次のコードスニペットは、PDF ファイルの個々のページを反復処理して色情報を取得する方法を示しています。

PDFドキュメントにページを追加する