PDFドキュメントのサイズ変更

ドキュメントのサイズは、ページ上のコンテンツを自動的にスケーリングすることで変更できます。ドキュメント全体または特定のページをスケーリングできます。利用可能なメソッドは3つあります：

bool PdfFileEditor.ResizeContents(string source, string destination, int[] pages, ContentsResizeParameters parameters)
void PdfFileEditor.ResizeContents(Document source, int[] pages, ContentsResizeParameters parameters)
void PdfFileEditor.ResizeContents(Document source, ContentsResizeParameters parameters)

オプションクラスの説明

サイズ変更パラメータは、オプションクラスPdfFileEditor.ContentsResizeParametersによって定義されます。

目的

コンテンツの周囲のマージン、ターゲットコンテンツの寸法、およびページの寸法を設定します。
絶対単位とパーセンテージの両方をサポートします。
サイズ変更中にMediaBoxをCropBoxに合わせて調整するオプションがあります。

主なエンティティ

ContentsResizeParameters

パラメータコンテナ。

プロパティ:
- ChangeMediaBox: 有効にすると、サイズ変更中にMediaBoxが現在のCropBoxに調整されます。
- LeftMargin, RightMargin, TopMargin, BottomMargin: コンテンツの周囲のマージン（絶対またはパーセンテージ）。
- ContentsWidth, ContentsHeight: ターゲットコンテンツエリアのサイズ（絶対またはパーセンテージ）。
静的構成メソッド（新しいContentsResizeParametersオブジェクトを作成）:
- Margins(left, right, top, bottom): 絶対ページ単位でのマージン。
- MarginsPercent(left, right, top, bottom): パーセンテージでのマージン。
- ContentSize(width, height): 絶対単位でのターゲットコンテンツサイズ。
- ContentSizePercent(width, height): パーセンテージでのターゲットコンテンツサイズ。
- PageResize(width, height): 絶対単位でのページサイズを変更。
- PageResizePct(widthPct, heightPct): パーセンテージでのページサイズを変更。

上記の静的メソッドのいずれかを使用してContentsResizeParametersオブジェクトを作成し、そのフィールドを追加で調整できます。

ContentsResizeValue

数値パラメータのためのユニバーサルコンテナ。

値の種類:
- 絶対（Units）
- パーセンテージ（Percents）
- 自動（Auto）
主要フィールド/フラグ:
- Value: 数値。
- IsPercent: パーセンテージ解釈を示します。falseの場合は絶対値。
ファクトリメソッド:
- Units(value): 絶対値を作成。
- Percents(value): パーセンテージ値を作成。
- Auto(): 自動計算用に値をマーク。

使用推奨

コンテンツの周囲のマージンが重要な場合は、MarginsまたはMarginsPercentを使用します。
コンテンツを特定の寸法に合わせる必要がある場合は、ContentSizeまたはContentSizePercentを使用します。
ページサイズ自体を変更する必要がある場合は、PageResizeまたはPageResizePctを使用します。
絶対値とパーセンテージ値を組み合わせることができます。
ページのジオメトリを整列させる必要がある場合は、ChangeMediaBoxを有効にします：MediaBoxは現在のCropBoxに設定されます。
計算をアルゴリズムに委任したい場合は、パラメータをAutoとしてマークします。

例

ページのサイズ変更の例

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void ResizePage(Document document, int pageNumber, double targetWidth, double targetHeight, double width, double height)
{
    double marginWidth = (targetWidth - width) / 2;
    double marginHeight = (targetHeight - height) / 2;
   
    // Set the parameters
    var param =
        Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeParameters.PageResize(width, height);
    param.TopMargin = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeValue.Units(marginHeight);
    param.BottomMargin = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeValue.Units(marginHeight);
    param.LeftMargin = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeValue.Units(marginWidth);
    param.RightMargin = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeValue.Units(marginWidth);
    param.ChangeMediaBox = true;
    
    // Do resize
    new Aspose.Pdf.Facades.PdfFileEditor().ResizeContents(document, new int[] { pageNumber }, param);
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void ResizePage(Document document, int pageNumber, double targetWidth, double targetHeight, double width, double height)
{
    double marginWidth = (targetWidth - width) / 2;
    double marginHeight = (targetHeight - height) / 2;
   
    // Set the parameters
    var param =
        Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeParameters.PageResize(width, height);
    param.TopMargin = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeValue.Units(marginHeight);
    param.BottomMargin = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeValue.Units(marginHeight);
    param.LeftMargin = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeValue.Units(marginWidth);
    param.RightMargin = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeValue.Units(marginWidth);
    param.ChangeMediaBox = true;
    
    // Do resize
    new Aspose.Pdf.Facades.PdfFileEditor().ResizeContents(document, new int[] { pageNumber }, param);
}

すべての側でページマージンを10%増加させる：

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void AddMargin(Document document)
{ 
    // Set the parameters
    var param = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeParameters.MarginsPercent(10, 10, 10, 10);
    
    // Do resize
    new Aspose.Pdf.Facades.PdfFileEditor().ResizeContents(document, param);
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void AddMargin(Document document)
{ 
    // Set the parameters
    var param = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeParameters.MarginsPercent(10, 10, 10, 10);
    
    // Do resize
    new Aspose.Pdf.Facades.PdfFileEditor().ResizeContents(document, param);
}

コンテンツサイズをページ単位で500 x 700に設定し、マージンは自動のままにする：

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void ResizeAndAutoMargin(Document document)
{
    // Set the parameters
    var param = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeParameters.ContentSize(500, 700);

    // Do resize
    new Aspose.Pdf.Facades.PdfFileEditor().ResizeContents(document, param);
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void ResizeAndAutoMargin(Document document)
{
    // Set the parameters
    var param = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeParameters.ContentSize(500, 700);

    // Do resize
    new Aspose.Pdf.Facades.PdfFileEditor().ResizeContents(document, param);
}

ページを幅120%、高さ110%でスケーリングする：

.NET Core 3.1

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void ResizeInPercents(Document document)
{
    // Set the parameters
    var param = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeParameters.PageResizePct(120, 110);

    // Do resize
    new Aspose.Pdf.Facades.PdfFileEditor().ResizeContents(document, param);
}

.NET 8

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
private static void ResizeInPercents(Document document)
{
    // Set the parameters
    var param = Aspose.Pdf.Facades.PdfFileEditor.ContentsResizeParameters.PageResizePct(120, 110);

    // Do resize
    new Aspose.Pdf.Facades.PdfFileEditor().ResizeContents(document, param);
}

注意事項

パーセンテージは、対応する元のサイズに対して解釈されます。
絶対値はページ単位で指定されます（例：ポイント）。
マージンとターゲットコンテンツサイズが一緒に設定されると、最終値はすべての制約を考慮して計算されます。指定されていないパラメータは自動的に計算される場合があります。

PDFファイルのNUpを作成する