PDF ファイル内のカスタム タブ ストップ

導入

PDF 内のテキストをフォーマットする必要があり、各単語の配置を正確に制御したいと思ったことはありませんか? タブ ストップが便利なのは、まさにこのときです。Word 文書と同様に、カスタム タブ ストップを使用して、PDF 内の特定のポイントでテキストを完璧に配置できます。コンテンツを右揃え、中央揃え、または左揃えにしたい場合、Aspose.PDF for .NET を使用すると簡単にできます。このチュートリアルでは、Aspose.PDF for .NET を使用して PDF ファイルにカスタム タブ ストップを設定する方法について説明します。最後には、美しく整列された文書を簡単に作成できるようになります。

前提条件

始める前に、以下のものを用意しておく必要があります。

  • Aspose.PDF for .NET: Aspose.PDFライブラリがインストールされている必要があります。ここからダウンロード.
  • .NET 開発環境: .NET アプリケーションを実行するために Visual Studio または別の IDE が設定されていることを確認します。
  • C# の基本的な理解: C# でコードを記述するため、C# に関するある程度の知識があることが推奨されます。
  • 一時ライセンス：一時ライセンスAspose.PDF for .NET のすべての機能のロックを解除します。

準備が整ったら、必要なパッケージをインポートして環境をセットアップする手順に進みます。

パッケージのインポート

まず、Aspose.PDF 名前空間をインポートする必要があります。手順は次のとおりです。

using System.IO;
using Aspose.Pdf;
using Aspose.Pdf.Text;
using System;

この2行は重要です。Aspose.Pdf名前空間は文書構造を提供し、Aspose.Pdf.Textカスタム タブ ストップなどのテキスト固有の機能にアクセスできます。

PDF でカスタム タブ ストップを設定するプロセスを詳しく説明します。各ステップを詳しく説明して、何が起こっているのかを正確に理解できるようにします。

ステップ1: 新しいPDFドキュメントを作成する

まず最初に、新しい PDF ドキュメントを作成します。これをキャンバスと考えてください。ページを追加し、書式設定されたテキストをその上に配置します。

string dataDir = "YOUR DOCUMENT DIRECTORY";
Document _pdfdocument = new Document();
Page page = _pdfdocument.Pages.Add();

このスニペットでは:

  • 私たちは新しいDocument物体。
  • ドキュメントに新しいページを追加するには、Pages.Add()ここでタブストップ付きのテキストを挿入します。

ステップ2: タブストップを設定する

空白のドキュメントができたので、タブ ストップを定義します。タブ ストップは、ページ上のさまざまな位置でテキストをどのように配置するかを制御します。たとえば、一部のテキストを右に揃え、他のテキストを中央または左に揃えたい場合があります。

Aspose.Pdf.Text.TabStops ts = new Aspose.Pdf.Text.TabStops();
Aspose.Pdf.Text.TabStop ts1 = ts.Add(100);
ts1.AlignmentType = TabAlignmentType.Right;
ts1.LeaderType = TabLeaderType.Solid;

ここでは、次のことを行います。

  • 初期化するTabStopsオブジェクトは、カスタム タブ ストップを保持します。
  • 100ピクセルの位置にタブストップを追加するには、ts.Add(100). タブが出現する場所を定義します。
  • 配置タイプをRightつまり、このタブ ストップに当たるテキストは右揃えになります。
  • リーダーの種類を定義します。リーダーとは、タブ ストップの前のスペースを埋める点またはダッシュです。この場合は、実線を使用します。

ステップ3: タブストップを追加する

必要な数だけタブ ストップを追加できます。この例では、中央揃えのタブと左揃えのタブも追加します。

Aspose.Pdf.Text.TabStop ts2 = ts.Add(200);
ts2.AlignmentType = TabAlignmentType.Center;
ts2.LeaderType = TabLeaderType.Dash;

Aspose.Pdf.Text.TabStop ts3 = ts.Add(300);
ts3.AlignmentType = TabAlignmentType.Left;
ts3.LeaderType = TabLeaderType.Dot;
  • 2 番目のタブ ストップは、中央揃えとダッシュ リーダーで 200 ピクセルに設定されています。
  • 3 番目のタブ ストップは 300 ピクセルに配置され、左揃えで配置され、点線のリーダーが使用されます。

ステップ4: タブストップ付きのテキストを作成する

タブ ストップが設定されたので、次はタブ ストップを使用するテキストを作成します。これらのタブ ストップは、コンテンツをさまざまな位置に揃えるのに役立つ目に見えないガイドと考えることができます。

TextFragment header = new TextFragment("This is an example of forming a table with TAB stops", ts);
TextFragment text0 = new TextFragment("#$TABHead1 #$TABHead2 #$TABHead3", ts);
TextFragment text1 = new TextFragment("#$TABdata11 #$TABdata12 #$TABdata13", ts);
  • TextFragmentテキストの一部を表します。
  • タブマーカー（#$TAB) を使用して、タブ ストップを適用する場所を PDF に指示します。
  • 例えば、text0, #$TABHead1最初のタブ位置に合わせて配置されます。#$TABHead2 2番目に揃えられます。

ステップ5: テキストにセグメントを追加する

場合によっては、テキストを複数のセグメントに分割し、それぞれにタブストップを設定する必要があることがあります。TextSegment便利です。

TextFragment text2 = new TextFragment("#$TABdata21 ", ts);
text2.Segments.Add(new TextSegment("#$TAB"));
text2.Segments.Add(new TextSegment("data22 "));
text2.Segments.Add(new TextSegment("#$TAB"));
text2.Segments.Add(new TextSegment("data23"));

この場合：

  • まずは#$TABdata21最初のタブ ストップに揃えられます。
  • 次のようなセグメントを追加しますdata22そしてdata23それぞれ異なるタブストップに揃えられます。

ステップ6: PDFページにテキストを追加する

すべてのテキストフラグメントを作成したので、次にそれらをページに追加します。

page.Paragraphs.Add(header);
page.Paragraphs.Add(text0);
page.Paragraphs.Add(text1);
page.Paragraphs.Add(text2);

このコードはそれぞれTextFragmentPDF ページに、テキストがタブ ストップに従ってフォーマットされていることを確認します。

ステップ7: PDFドキュメントを保存する

最後に、指定したディレクトリにドキュメントを保存する必要があります。

dataDir = dataDir + "CustomTabStops_out.pdf";
_pdfdocument.Save(dataDir);
Console.WriteLine("\nCustom tab stops setup successfully.\nFile saved at " + dataDir);
  • PDF ファイルは、カスタム タブ ストップが適用された状態で保存されます。
  • ファイルが正常に作成されたことを確認するメッセージが表示されます。

結論

これで完了です。このガイドに従って、Aspose.PDF for .NET を使用して PDF ドキュメントにカスタム タブ ストップを作成する方法を学習しました。タブ ストップを使用すると、テキストを構造化され、視覚的に魅力的な方法で配置できるため、PDF がよりプロフェッショナルになります。請求書の詳細、表、またはその他の形式のデータを配置する場合でも、この機能を使用すると、テキストの配置を完全に制御できます。

よくある質問

既存の PDF にタブ ストップを適用できますか?

はい、カスタム タブ ストップを追加してテキストを揃えることで、既存の PDF を変更できます。

利用可能なリーダータイプは何ですか?

タブストップの前のスペースを埋めるために、実線、破線、点線、その他のリーダー タイプを選択できます。

行に複数の種類の配置を追加できますか?

もちろんです! 例に示すように、同じ行に右揃え、左揃え、中央揃えを組み合わせることができます。

追加できるタブストップの数に制限はありますか?

いいえ、デザイン要件に合わせて必要な数のタブ ストップを追加できます。

タブストップの位置をカスタマイズできますか?

はい、レイアウトに合わせて各タブ ストップの正確なピクセル位置を定義できます。

複数列の PDF を作成する PDF ファイル内の改行を決定する