ScaleImageToShapeSize

HtmlSaveOptions.ScaleImageToShapeSize property

يحدد ما إذا كانت الصور يتم قياسها بواسطة Aspose.Words إلى حجم الشكل المحيط عند التصدير إلى HTML أو MHTML أو EPUB. القيمة الافتراضية هيحقيقي .

public bool ScaleImageToShapeSize { get; set; }

ملاحظات

الصورة في مستند مايكروسوفت وورد هي شكل. للشكل حجم، وللصورة image حجمها الخاص. لا ترتبط الأحجام مباشرةً. على سبيل المثال، يمكن أن تكون الصورة 1024×786 بكسل، ولكن الشكل الذي يعرض هذه الصورة يمكن أن يكون 400×300 نقطة.

لعرض صورة في المتصفح، يجب أن يتم قياسها إلى حجم الشكل. ScaleImageToShapeSize تتحكم الخاصية في المكان الذي يتم فيه تغيير مقياس image : في Aspose.Words أثناء التصدير إلى HTML أو في المتصفح عند عرض المستند.

متىScaleImageToShapeSize يكونحقيقي يتم قياس الصورة باستخدام Aspose.Words باستخدام مقياس عالي الجودة أثناء التصدير إلى HTML. عندScaleImageToShapeSize هوخطأ شنيعيتم إخراج الصورة بحجمها الأصلي ويتعين على المتصفح تغيير حجمها.

بشكل عام، تُجري المتصفحات عملية تحجيم سريعة وبطيئة الجودة. ونتيجةً لذلك، ستحصل عادةً على جودة عرض أفضل في المتصفح وحجم ملف أصغر عندScaleImageToShapeSize يكونحقيقي ، ولكن جودة الطباعة أفضل والتحويل أسرع عندScaleImageToShapeSize يكونخطأ شنيع.

بالإضافة إلى الأشكال التي تحتوي على صور نقطية فردية، يؤثر هذا الخيار أيضًا على أشكال المجموعة المكونة من صور نقطية. إذاScaleImageToShapeSize يكونخطأ شنيع ويحتوي شكل المجموعة على صور نقطية ذات دقة جوهرية أعلى من القيمة المحددة فيImageResolutionسيؤدي استخدام Aspose.Words إلى زيادة دقة عرض هذه المجموعة. هذا يسمح بالحفاظ على جودة الصور عالية الدقة المجمعة بشكل أفضل عند الحفظ بتنسيق HTML.

أمثلة

يوضح كيفية تعطيل تغيير مقياس الصور إلى أبعاد شكلها الأصلي عند الحفظ في .html.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// قم بإدراج شكل يحتوي على صورة، ثم اجعل هذا الشكل أصغر بكثير من الصورة.
Shape imageShape = builder.InsertImage(ImageDir + "Transparent background logo.png");
imageShape.Width = 50;
imageShape.Height = 50;

// سيؤدي حفظ مستند يحتوي على أشكال مع صور إلى HTML إلى إنشاء ملف صورة في نظام الملفات المحلي
// لكل شكل. سيستخدم مستند HTML الناتج وسم <image> للربط بهذه الصور وعرضها.
// عندما نحفظ المستند في HTML، يمكننا تمرير كائن SaveOptions لتحديد
// ما إذا كان سيتم تغيير حجم جميع الصور الموجودة داخل الأشكال إلى أحجام أشكالها.
// تعيين علامة "ScaleImageToShapeSize" إلى "true" سيؤدي إلى تقليص حجم كل صورة
// إلى حجم الشكل الذي يحتويه، بحيث لا تكون الصور المحفوظة أكبر من الحجم المطلوب في المستند.
// سيؤدي تعيين علامة "ScaleImageToShapeSize" إلى "false" إلى الحفاظ على أحجام هذه الصور الأصلية،
// مما سيشغل مساحة أكبر مقابل الحفاظ على جودة الصورة.
HtmlSaveOptions options = new HtmlSaveOptions { ScaleImageToShapeSize = scaleImageToShapeSize };

doc.Save(ArtifactsDir + "HtmlSaveOptions.ScaleImageToShapeSize.html", options);

أنظر أيضا

HtmlSaveOptions.SaveFormat HtmlSaveOptions.TableWidthOutputMode