閲覧時にページを指定する

導入

ドキュメントを開いたときにユーザーを特定のページへ誘導することで PDF アプリケーションを強化したいとお考えですか? まさにうってつけのガイドです! このガイドでは、Aspose.PDF for .NET を使用して PDF を開いたときに表示するページを指定する方法について詳しく説明します。この機能により、特にドキュメントの重要なセクションに注意を向ける必要がある場合に、ユーザー エクスペリエンスを大幅に向上できます。

前提条件

コーディングを始める前に、始めるのに必要なものがすべて揃っていることを確認しましょう。必要なものは次のとおりです。

  1. .NET の基礎知識: .NET フレームワークに精通していることが必須です。C# に慣れていて、オブジェクト指向プログラミングの基礎を理解していれば、準備は完了です。

  2. Aspose.PDF for .NET: プロジェクトにAspose.PDFライブラリをインストールする必要があります。まだインストールしていない場合は、ダウンロードできます。ここ.

  3. Visual Studio: このチュートリアルでは、IDE として Visual Studio を使用していることを前提としています。マシンに Visual Studio がインストールされていることを確認してください。

  4. PDF ファイル: 作業に使用する既存の PDF ファイルが必要です。PDF ファイルがない場合、サンプル ドキュメントを作成するか、任意の PDF を使用できます。

これらの前提条件が整ったら、袖をまくってコーディングを開始できます。

パッケージのインポート

準備が完了したら、必要なパッケージをプロジェクトにインポートしましょう。次の手順に従います。

Visual Studioを起動する

Visual Studio を開き、PDF ページ表示機能を実装する新しいプロジェクトを作成するか、既存のプロジェクトを読み込みます。

参照 Aspose.PDF

Aspose.PDF ライブラリを使用するには、ライブラリへの参照を追加する必要があります。

  1. ソリューション エクスプローラーでプロジェクトを右クリックします。
  2. 「NuGet パッケージの管理」を選択します。
  3. 検索するAspose.PDFパッケージをインストールします。

名前空間のインポート

コード ファイルの先頭に次の using ディレクティブを追加します。

using System;
using System.IO;
using Aspose.Pdf.Annotations;
using Aspose.Pdf;

これで、PDF ページ ナビゲーション ロジックの構築を開始する準備が整いました。

タスクを管理しやすいステップに分解してみましょう。PDF ドキュメントを開き、表示時に表示する特定のページを指定して、更新されたドキュメントを保存するコードを記述します。

ステップ1: ドキュメントディレクトリを設定する

まず、ドキュメントへのパスを設定する必要があります。

//ドキュメント ディレクトリへのパス。
string dataDir = "YOUR DOCUMENT DIRECTORY"; //ディレクトリに置き換えます

この行は基本的にロードマップです。コードにPDFファイルの場所を指示します。YOUR DOCUMENT DIRECTORYマシン上の実際のパスを使用します。

ステップ2: PDFファイルを読み込む

次に、PDF ファイルをアプリケーションに読み込みます。

// PDFファイルを読み込む
Document doc = new Document(dataDir + "SpecifyPageWhenViewing.pdf");

ここで起こっていることは、新しいインスタンスを作成しているということですDocumentオブジェクトを使用して PDF ファイルへのパスを指定します。テーブルの上に置いた本を開くようなものと考えることができます。

ステップ3: 目的のページにアクセスする

次に、ドキュメントを開いたときに表示するページにアクセスします。

//ドキュメントの2ページ目のインスタンスを取得する
Page page2 = doc.Pages[2]; //インデックスは1から始まることを覚えておいてください

ここでは、ドキュメントの 2 ページ目にアクセスしています。このコンテキストではページ番号は 1 から始まるので、2 ページ目についてはインデックス 2 を使用する必要があります。

ステップ4: ズーム係数を設定する

表示されるページのズーム レベルを調整できます。

//対象ページのズーム率を設定する変数を作成する
double zoom = 1; //1は100%ズームを意味します

ズーム係数を設定すると、ページを開いた直後にユーザーがページをどの程度見るかを決めるのに役立ちます。値が 1 の場合、ページは 100% のズームで表示されます。これは通常、適切なデフォルトです。

ステップ5: GoToActionインスタンスを作成する

ナビゲーション機能を実際に使ってみましょう。

// GoToActionインスタンスを作成する
GoToAction action = new GoToAction(doc.Pages[2]);

このステップでは、GoToActionこれは基本的に、PDF 内の特定のポイント (この場合は 2 ページ目) に移動するアクションを表します。

ステップ6: 目的地を定義する

次に、アクションがどこにつながるかを定義する必要があります。

// 2ページ目へ
action.Destination = new XYZExplicitDestination(page2, 0, page2.Rect.Height, zoom);

この行は、GoToAction の GPS 目的地を設定するようなものです。ページの上部 (高さ) と指定されたズーム レベルでページ 2 に移動するように指示します。

ステップ7: 開くアクションを設定する

ドキュメントを開いたときにこのアクションが実行されることを確認しましょう。

//ドキュメントを開くアクションを設定する
doc.OpenAction = action;

これにより、PDF を開いたときに、定義したナビゲーション アクションがアクティブになることを宣言しました。これは、ドキュメントの正面玄関にウェルカム マットを設置したようなものです。

ステップ8: 更新したドキュメントを保存する

最後に、変更を加えたドキュメントを保存します。

//更新されたドキュメントを保存する
doc.Save(dataDir + "goto2page_out.pdf");

このステップで作業は完了です。新しいPDFファイルが作成されます。goto2page_out.pdf指定したページが直接開きます。

これで、コーディング部分は完了です。PDF を開いたときに特定のページを表示するように Aspose.PDF をプログラムできました。

結論

このガイドでは、Aspose.PDF for .NET を使用して PDF ファイル内のページを指定する方法を段階的に説明しました。この機能により、ユーザーのナビゲーションが改善されるだけでなく、ドキュメント内の重要なコンテンツとのやり取りも効率化されます。このような機能を活用することで、PDF アプリケーションを差別化できる、よりユーザーフレンドリーなエクスペリエンスを実現できます。

よくある質問

Aspose.PDF for .NET とは何ですか?

Aspose.PDF for .NET は、開発者が .NET アプリケーション内で PDF ドキュメントを作成、変更、管理できるようにするライブラリです。

表示するページを複数指定できますか？

いいえ、ドキュメントは 1 つの指定されたページでのみ開くように設定できます。ただし、異なる初期ページごとに異なるドキュメントを作成することはできます。

ページを別のズームレベルで表示したい場合はどうすればいいですか?

ズームレベルを変更するには、zoomドキュメントを保存する前に変数を変更します。

Aspose.PDF の使用例をもっと知りたい場合はどこに行けばいいですか?

確認するにはドキュメントその他の例と機能については、こちらをご覧ください。

Aspose.PDF for .NET の無料試用版はありますか?

はい！Aspose.PDFの無料トライアルをダウンロードできます。ここ.

PDF ファイルにターゲット リンクを設定する PDF ファイル内のリンクを更新する