Mengubah Ukuran Dokumen PDF

Anda dapat mengubah ukuran dokumen dengan secara otomatis menskalakan konten di halamannya. Anda dapat menskalakan seluruh dokumen atau halaman tertentu. Ada tiga metode yang tersedia:

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)

Deskripsi Kelas Opsi

Parameter pengubahan ukuran didefinisikan oleh kelas opsi — PdfFileEditor.ContentsResizeParameters.

Tujuan

Mengonfigurasi margin di sekitar konten, dimensi konten target, dan dimensi halaman.
Mendukung baik unit absolut maupun persentase.
Secara opsional menyesuaikan MediaBox untuk mencocokkan CropBox selama pengubahan ukuran.

Entitas Utama

ContentsResizeParameters

Sebuah wadah parameter.

Properti:
- ChangeMediaBox: ketika diaktifkan, MediaBox disesuaikan dengan CropBox saat ini selama pengubahan ukuran.
- LeftMargin, RightMargin, TopMargin, BottomMargin: margin di sekitar konten (absolut atau persentase).
- ContentsWidth, ContentsHeight: ukuran area konten target (absolut atau persentase).
Metode konfigurasi statis (membuat objek ContentsResizeParameters baru):
- Margins(left, right, top, bottom): margin dalam unit halaman absolut.
- MarginsPercent(left, right, top, bottom): margin dalam persentase.
- ContentSize(width, height): ukuran konten target dalam unit absolut.
- ContentSizePercent(width, height): ukuran konten target dalam persentase.
- PageResize(width, height): mengubah ukuran halaman dalam unit absolut.
- PageResizePct(widthPct, heightPct): mengubah ukuran halaman dalam persentase.

Anda dapat membuat objek ContentsResizeParameters menggunakan salah satu metode statis di atas dan kemudian menyesuaikan bidangnya lebih lanjut.

ContentsResizeValue

Sebuah wadah universal untuk parameter numerik.

Tipe nilai:
- Absolut (Units)
- Persentase (Percents)
- Otomatis (Auto)
Bidang/flag kunci:
- Value: nilai numerik.
- IsPercent: menunjukkan interpretasi persentase; jika false — nilai absolut.
Metode pabrik:
- Units(value): membuat nilai absolut.
- Percents(value): membuat nilai persentase.
- Auto(): menandai nilai untuk perhitungan otomatis.

Rekomendasi Penggunaan

Ketika margin di sekitar konten penting — gunakan Margins atau MarginsPercent.
Ketika Anda perlu konten sesuai dengan dimensi tertentu — gunakan ContentSize atau ContentSizePercent.
Ketika Anda perlu mengubah ukuran halaman itu sendiri — gunakan PageResize atau PageResizePct.
Anda dapat menggabungkan nilai absolut dan persentase.
Aktifkan ChangeMediaBox jika Anda perlu menyelaraskan geometri halaman: MediaBox akan diatur ke CropBox saat ini.
Tandai parameter sebagai Auto ketika Anda ingin mendelegasikan perhitungan kepada algoritma.

Contoh

Contoh mengubah ukuran halaman

.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);
}

Tingkatkan margin halaman sebesar 10% di semua sisi:

.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);
}

Atur ukuran konten menjadi 500 x 700 dalam unit halaman dan biarkan margin sebagai otomatis:

.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);
}

Skala halaman sebesar 120% lebar dan 110% tinggi:

.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);
}

Catatan

Persentase diinterpretasikan relatif terhadap ukuran asli yang sesuai.
Nilai absolut ditentukan dalam unit halaman (misalnya, poin).
Ketika margin dan ukuran konten target diatur bersama, nilai akhir dihitung dengan mempertimbangkan semua batasan; parameter yang tidak ditentukan dapat dihitung secara otomatis.

Buat NUp dari file PDF