Изменение размера PDF документа

Вы можете изменить размер документа, автоматически масштабируя содержимое на его страницах. Вы можете масштабировать весь документ или конкретные страницы. Доступно три метода:

• 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)

Описание класса Options

Параметры изменения размера определяются классом опций — 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);
}

Примечания

• Проценты интерпретируются относительно соответствующего оригинального размера.
• Абсолютные значения указываются в единицах страницы (например, пункты).
• Когда отступы и целевой размер содержимого устанавливаются вместе, окончательные значения вычисляются с учетом всех ограничений; неуказанные параметры могут быть вычислены автоматически.