تغيير حجم مستند 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)

وصف فئة الخيارات

تُحدد معلمات تغيير الحجم بواسطة فئة الخيارات — 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 × 700 بوحدات الصفحة وترك الهوامش كـ auto:

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

ملاحظات

• يتم تفسير النسب المئوية بالنسبة للحجم الأصلي المقابل.
• يتم تحديد القيم المطلقة بوحدات الصفحة (مثل النقاط).
• عند تعيين الهوامش وحجم المحتوى المستهدف معًا، يتم حساب القيم النهائية مع مراعاة جميع القيود؛ قد يتم حساب المعلمات غير المحددة تلقائيًا.