RenderToSize

Document.RenderToSize method

يعرض صفحة مستند فيGraphics الكائن إلى حجم محدد.

public float RenderToSize(int pageIndex, Graphics graphics, float x, float y, float width, 
    float height)

معامل	يكتب	وصف
pageIndex	Int32	فهرس الصفحة المبني على 0.
graphics	Graphics	الكائن الذي سيتم تقديمه إليه.
x	Single	إحداثيات X (بالوحدات العالمية) في الزاوية العلوية اليسرى من الصفحة المرسومة.
y	Single	إحداثيات Y (بالوحدات العالمية) في الزاوية العلوية اليسرى من الصفحة المرسومة.
width	Single	الحد الأقصى للعرض (بالوحدات العالمية) الذي يمكن أن تشغله الصفحة المقدمة.
height	Single	الارتفاع الأقصى (بالوحدات العالمية) الذي يمكن أن تشغله الصفحة المقدمة.

قيمة الإرجاع

المقياس الذي تم حسابه تلقائيًا للصفحة المقدمة لتناسب الحجم المحدد.

أمثلة

يوضح كيفية عرض المستند كخريطة نقطية في موقع وحجم محددين (.NetStandard 2.0).

Document doc = new Document(MyDir + "Rendering.docx");

using (SKBitmap bitmap = new SKBitmap(700, 700))
{
    using (SKCanvas canvas = new SKCanvas(bitmap))
    {
        // قم بتطبيق عامل مقياس بنسبة 70% على الصفحة التي سنقوم بعرضها باستخدام هذه اللوحة القماشية.
        canvas.Scale(70);

        //إزاحة الصفحة بمقدار 0.5 بوصة من الحواف العلوية واليسرى للصفحة.
        canvas.Translate(0.5f, 0.5f);

        // تدوير الصفحة المقدمة بمقدار 10 درجات.
        canvas.RotateDegrees(10);

        // إنشاء مستطيل ورسمه.
        SKRect rect = new SKRect(0f, 0f, 3f, 3f);
        canvas.DrawRect(rect, new SKPaint
        {
            Color = SKColors.Black,
            Style = SKPaintStyle.Stroke,
            StrokeWidth = 3f / 72f
        });

        // قم بعرض الصفحة الأولى من المستند بنفس حجم المستطيل أعلاه.
        // سوف يقوم المستطيل بتأطير هذه الصفحة.
        float returnedScale = doc.RenderToSize(0, canvas, 0f, 0f, 3f, 3f);

        Console.WriteLine("The image was rendered at {0:P0} zoom.", returnedScale);

        // إعادة تعيين المصفوفة، ثم تطبيق مجموعة جديدة من القياسات والترجمات.
        canvas.ResetMatrix();
        canvas.Scale(5);
        canvas.Translate(10, 10);

        // إنشاء مستطيل آخر.
        rect = new SKRect(0, 0, 50, 100);
        rect.Offset(90, 10);
        canvas.DrawRect(rect, new SKPaint
        {
            Color = SKColors.Black,
            Style = SKPaintStyle.Stroke,
            StrokeWidth = 1
        });

        // قم بعرض الصفحة الأولى داخل المستطيل الذي تم إنشاؤه حديثًا مرة أخرى.
        doc.RenderToSize(0, canvas, 90, 10, 50, 100);

        using (SKFileWStream fs = new SKFileWStream(ArtifactsDir + "Rendering.RenderToSizeNetStandard2.png"))
        {
            bitmap.PeekPixels().Encode(fs, SKEncodedImageFormat.Png, 100);
        }
    }
}

يوضح كيفية عرض مستند إلى خريطة نقطية في موقع وحجم محددين.

Document doc = new Document(MyDir + "Rendering.docx");

using (Bitmap bmp = new Bitmap(700, 700))
{
    using (Graphics gr = Graphics.FromImage(bmp))
    {
        gr.TextRenderingHint = TextRenderingHint.AntiAliasGridFit;

        // اضبط خاصية "PageUnit" على "GraphicsUnit.Inch" لاستخدام البوصات كوحدة
        // وحدة القياس لأي تحويلات وأبعاد سنقوم بتعريفها.
        gr.PageUnit = GraphicsUnit.Inch;

        //إزاحة الإخراج بمقدار 0.5 بوصة من الحافة.
        gr.TranslateTransform(0.5f, 0.5f);

        // قم بتدوير الإخراج بمقدار 10 درجات.
        gr.RotateTransform(10);

        // ارسم مستطيلًا بمقاس 3 × 3 بوصة.
        gr.DrawRectangle(new Pen(Color.Black, 3f / 72f), 0f, 0f, 3f, 3f);

        // ارسم الصفحة الأولى من مستندنا بنفس الأبعاد والتحويل مثل المستطيل.
        // المستطيل سوف يحيط بالصفحة الأولى.
        float returnedScale = doc.RenderToSize(0, gr, 0f, 0f, 3f, 3f);

        // هذا هو عامل القياس الذي طبقته طريقة RenderToSize على الصفحة الأولى لتناسب الحجم المحدد.
        Assert.AreEqual(0.2566f, returnedScale, 0.0001f);

        // اضبط خاصية "PageUnit" على "GraphicsUnit.Millimeter" لاستخدام المليمترات كوحدة
        // وحدة القياس لأي تحويلات وأبعاد سنقوم بتعريفها.
        gr.PageUnit = GraphicsUnit.Millimeter;

        // إعادة تعيين التحويلات التي استخدمناها من العرض السابق.
        gr.ResetTransform();

         // تطبيق مجموعة أخرى من التحويلات.
        gr.TranslateTransform(10, 10);
        gr.ScaleTransform(0.5f, 0.5f);
        gr.PageScale = 2f;

        // قم بإنشاء مستطيل آخر واستخدمه لتأطير صفحة أخرى من المستند.
        gr.DrawRectangle(new Pen(Color.Black, 1), 90, 10, 50, 100);
        doc.RenderToSize(1, gr, 90, 10, 50, 100);

        bmp.Save(ArtifactsDir + "Rendering.RenderToSize.png");
    }
}

أنظر أيضا

• class Document
• مساحة الاسم Aspose.Words
• المجسم Aspose.Words