PDFページスタンプの追加

PDFファイルのすべてのページにPDFページスタンプを追加

PdfFileStampクラスを使用すると、PDFファイルのすべてのページにPDFページスタンプを追加できます。PDFページスタンプを追加するには、まずPdfFileStampとStampクラスのオブジェクトを作成する必要があります。また、StampクラスのPdfFileStampメソッドを使用してPDFページスタンプを作成する必要があります。他の属性（原点、回転、背景など）もStampオブジェクトを使用して設定できます。その後、PdfFileStampクラスのAddStampメソッドを使用してPDFファイルにスタンプを追加できます。最後に、PdfFileStampクラスのCloseメソッドを使用して出力PDFファイルを保存します。以下のコードスニペットは、PDFファイルのすべてのページにPDFページスタンプを追加する方法を示しています。

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void AddPageStampOnAllPages()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_Images();

    // Create PdfFileStamp object
    using (var fileStamp = new Aspose.Pdf.Facades.PdfFileStamp())
    {
        // Bind PDF document
        fileStamp.BindPdf(dataDir + "SourcePDF.pdf");

        // Create stamp
        var stamp = new Aspose.Pdf.Facades.Stamp();
        // Bind PDF document
        stamp.BindPdf(dataDir + "AddPageStampOnAllPages.pdf", 1);
        stamp.SetOrigin(20, 20);
        stamp.Rotation = 90.0F;
        stamp.IsBackground = true;

        // Add stamp to PDF file
        fileStamp.AddStamp(stamp);

        // Save PDF document
        fileStamp.Save(dataDir + "PageStampOnAllPages_out.pdf");
    }
}

PDFファイルの特定のページにPDFページスタンプを追加

PdfFileStampクラスを使用すると、PDFファイルの特定のページにPDFページスタンプを追加できます。PDFページスタンプを追加するには、まずPdfFileStampとStampクラスのオブジェクトを作成する必要があります。また、StampクラスのBindPdfメソッドを使用してPDFページスタンプを作成する必要があります。他の属性（原点、回転、背景など）もStampオブジェクトを使用して設定できます。PDFファイルの特定のページにPDFページスタンプを追加するには、StampクラスのPagesプロパティを設定する必要があります。このプロパティには、スタンプを追加したいページの番号を含む整数配列が必要です。その後、PdfFileStampクラスのAddStampメソッドを使用してPDFファイルにスタンプを追加できます。最後に、PdfFileStampクラスのCloseメソッドを使用して出力PDFファイルを保存します。以下のコードスニペットは、PDFファイルの特定のページにPDFページスタンプを追加する方法を示しています。

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void AddPageStampOnCertainPages()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_Images();

    // Create PdfFileStamp object
    using (var fileStamp = new Aspose.Pdf.Facades.PdfFileStamp())
    {
        // Bind PDF document
        fileStamp.BindPdf(dataDir + "SourcePDF.pdf");

        // Create stamp
        var stamp = new Aspose.Pdf.Facades.Stamp();
        // Bind PDF document
        stamp.BindPdf(dataDir + "PageStampOnCertainPages.pdf", 1);
        stamp.SetOrigin(20, 20);
        stamp.Rotation = 90.0F;
        stamp.IsBackground = true;
        stamp.Pages = new[] { 1, 3 };  // Apply stamp to specific pages (1 and 3)

        // Add stamp to PDF file
        fileStamp.AddStamp(stamp);

        // Save PDF document
        fileStamp.Save(dataDir + "PageStampOnCertainPages_out.pdf");
    }
}

PDFファイルにページ番号を追加

PdfFileStampクラスを使用すると、PDFファイルにページ番号を追加できます。ページ番号を追加するには、まずPdfFileStampクラスのオブジェクトを作成する必要があります。「ページXのN」のようにページ番号を表示したい場合、Xは現在のページ番号、NはPDFファイルの総ページ数です。最初にPdfFileInfoクラスのNumberOfpagesプロパティを使用してページ数を取得する必要があります。現在のページ番号を取得するには、テキストの任意の場所に**#**記号を使用できます。ページ番号のテキストは、FormattedTextクラスを使用してフォーマットできます。特定の番号からページ番号を開始したい場合は、StartingNumberプロパティを設定できます。ファイルにページ番号を追加する準備ができたら、PdfFileStampクラスのAddPageNumberメソッドを呼び出す必要があります。最後に、PdfFileStampクラスのCloseメソッドを使用して出力PDFファイルを保存します。以下のコードスニペットは、PDFファイルにページ番号を追加する方法を示しています。

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void AddPageNumberInPdfFile()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_Images();

    // Create PdfFileStamp object
    using (var fileStamp = new Aspose.Pdf.Facades.PdfFileStamp())
    {
        // Bind PDF document
        fileStamp.BindPdf(dataDir + "StampPDF.pdf");

        // Get total number of pages
        int totalPages = new Aspose.Pdf.Facades.PdfFileInfo(dataDir + "StampPDF.pdf").NumberOfPages;

        // Create formatted text for page number
        var formattedText = new Aspose.Pdf.Facades.FormattedText($"Page # of {totalPages}",
            System.Drawing.Color.AntiqueWhite,
            System.Drawing.Color.Gray,
            Aspose.Pdf.Facades.FontStyle.TimesBoldItalic,
            Aspose.Pdf.Facades.EncodingType.Winansi,
            false, 12);

        // Set starting number for first page; you might want to start from 2 or more
        fileStamp.StartingNumber = 1;
        // Add page number in upper right corner
        fileStamp.AddPageNumber(formattedText, (int)PageNumPosition.PosUpperRight);

        // Save PDF document
        fileStamp.Save(dataDir + "AddPageNumber_out.pdf");
    }
}

// Add PDF Page Numbers
public enum PageNumPosition
{
    PosBottomMiddle, PosBottomRight, PosUpperRight, PosSidesRight, PosUpperMiddle, PosBottomLeft, PosSidesLeft, PosUpperLeft
}

カスタム番号スタイル

PdfFileStampクラスは、PDFドキュメント内にスタンプオブジェクトとしてページ番号情報を追加する機能を提供します。このリリース以前は、クラスはページ番号スタイルとして1,2,3,4のみをサポートしていました。しかし、PDFドキュメント内にページ番号スタンプを配置する際にカスタム番号スタイルを使用するという顧客からの要望がありました。この要件を満たすために、NumberingStyleプロパティが導入され、NumberingStyle列挙から値を受け入れます。この列挙で提供される値は以下の通りです。

  • 小文字のアルファベット。
  • 大文字のアルファベット。
  • アラビア数字。
  • ローマ数字（小文字）。
  • ローマ数字（大文字）。
// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void AddCustomPageNumberInPdfFile()
{
    // The path to the documents directory
    var dataDir = RunExamples.GetDataDir_AsposePdf_Images();

    // Create PdfFileStamp object
    using (var fileStamp = new Aspose.Pdf.Facades.PdfFileStamp())
    {
        // Bind PDF document
        fileStamp.BindPdf(dataDir + "StampPDF.pdf");

        // Get total number of pages
        int totalPages = new Aspose.Pdf.Facades.PdfFileInfo(dataDir + "StampPDF.pdf").NumberOfPages;

        // Create formatted text for page number
        var formattedText = new Aspose.Pdf.Facades.FormattedText($"Page # of {totalPages}",
            System.Drawing.Color.AntiqueWhite,
            System.Drawing.Color.Gray,
            Aspose.Pdf.Facades.FontStyle.TimesBoldItalic,
            Aspose.Pdf.Facades.EncodingType.Winansi,
            false, 12);

        // Specify numbering style as Numerals Roman UpperCase
        fileStamp.NumberingStyle = Aspose.Pdf.NumberingStyle.NumeralsRomanUppercase;

        // Set starting number for first page; you might want to start from 2 or more
        fileStamp.StartingNumber = 1;

        // Add page number in upper right corner
        fileStamp.AddPageNumber(formattedText, (int)PageNumPosition.PosUpperRight);

        // Save PDF document
        fileStamp.Save(dataDir + "AddCustomPageNumber_out.pdf");
    }
}

// Add PDF Page Numbers
public enum PageNumPosition
{
    PosBottomMiddle, PosBottomRight, PosUpperRight, PosSidesRight, PosUpperMiddle, PosBottomLeft, PosSidesLeft, PosUpperLeft
}
テキストおよび画像スタンプの追加