HtmlFixedSaveOptions

HtmlFixedSaveOptions class

يمكن استخدامه لتحديد خيارات إضافية عند حفظ مستند فيHtmlFixed تنسيق.

لمعرفة المزيد، قم بزيارةتحديد خيارات الحفظ مقالة توثيقية.

public class HtmlFixedSaveOptions : FixedPageSaveOptions

المنشئون

اسموصف
HtmlFixedSaveOptions()Default_Constructor

الخصائص

اسموصف
AllowEmbeddingPostScriptFonts { get; set; }يحصل على قيمة منطقية أو يعينها للإشارة إلى ما إذا كان سيتم السماح بتضمين الخطوط مع الخطوط العريضة لـ PostScript عند تضمين خطوط TrueType في مستند عند حفظه. القيمة الافتراضية هيخطأ شنيع .
ColorMode { get; set; }يحصل على قيمة تحدد كيفية عرض الألوان أو يعينها.
CssClassNamesPrefix { get; set; }يحدد البادئة التي تتم إضافتها إلى جميع أسماء الفئات في ملف style.css. القيمة الافتراضية هي"أوه" .
CustomTimeZoneInfo { get; set; }يحصل على أو يعين المنطقة الزمنية المحلية المخصصة المستخدمة لحقول التاريخ/الوقت.
DefaultTemplate { get; set; }يحصل على المسار إلى القالب الافتراضي (بما في ذلك اسم الملف) أو يعينه. القيمة الافتراضية لهذه الخاصية هيسلسلة فارغة (Empty ).
Dml3DEffectsRenderingMode { get; set; }يحصل على قيمة تحدد كيفية عرض التأثيرات ثلاثية الأبعاد أو يعينها.
virtual DmlEffectsRenderingMode { get; set; }يحصل على قيمة تحدد كيفية عرض تأثيرات DrawingML أو يعينها.
DmlRenderingMode { get; set; }يحصل على قيمة تحدد كيفية عرض أشكال DrawingML أو يعينها.
Encoding { get; set; }يحدد الترميز الذي سيتم استخدامه عند التصدير إلى HTML. القيمة الافتراضية هيترميز UTF8 الجديد (true) (UTF-8 مع BOM).
ExportEmbeddedCss { get; set; }يحدد ما إذا كان يجب تضمين CSS (ورقة الأنماط المتتالية) في مستند HTML.
ExportEmbeddedFonts { get; set; }يحدد ما إذا كان يجب تضمين الخطوط في مستند HTML بتنسيق Base64. لاحظ أن تعيين هذا العلم يمكن أن يزيد بشكل كبير من حجم ملف HTML الناتج.
ExportEmbeddedImages { get; set; }يحدد ما إذا كان يجب تضمين الصور في مستند HTML بتنسيق Base64. لاحظ أن تعيين هذا العلم يمكن أن يزيد بشكل كبير من حجم ملف HTML الناتج.
ExportEmbeddedSvg { get; set; }يحدد ما إذا كان يجب تضمين موارد SVG في مستند HTML. القيمة الافتراضية هيحقيقي .
ExportFormFields { get; set; }يحصل على أو يعين مؤشرًا حول ما إذا كانت حقول النموذج يتم تصديرها كعناصر interactive (كعلامة “إدخال”) بدلاً من تحويلها إلى نص أو رسومات.
ExportGeneratorName { get; set; }عندماحقيقي ، يؤدي إلى تضمين اسم وإصدار Aspose.Words في الملفات المنتجة. القيمة الافتراضية هيحقيقي .
FontFormat { get; set; }يحصل أو يعينExportFontFormat يستخدم لتصدير الخط. القيمة الافتراضية هيWoff .
IdPrefix { get; set; }يحدد بادئة يتم إضافتها مسبقًا إلى جميع معرفات العناصر المولدة في المستند الناتج. القيمة الافتراضية هي null ولا يتم إضافة أي بادئة مسبقًا.
ImlRenderingMode { get; set; }يحصل على قيمة تحدد كيفية عرض كائنات الحبر (InkML) أو يعينها.
JpegQuality { get; set; }يحصل على قيمة تحدد جودة صور JPEG داخل مستند HTML أو يعينها.
MemoryOptimization { get; set; }يحصل على القيمة أو يعينها لتحديد ما إذا كان يجب إجراء تحسين الذاكرة قبل حفظ المستند. القيمة الافتراضية لهذه الخاصية هيخطأ شنيع .
MetafileRenderingOptions { get; set; }يسمح بتحديد خيارات عرض الملف التعريفي.
NumeralFormat { get; set; }يحصل أو يعينNumeralFormat تُستخدم لعرض الأرقام. يتم استخدام الأرقام الأوروبية بشكل افتراضي.
override OptimizeOutput { get; set; }يشير العلم إلى ما إذا كان مطلوبًا لتحسين الإخراج. إذا تم تعيين هذا العلم، تتم إزالة اللوحات المتداخلة الزائدة واللوحات الفارغة، يتم أيضًا ربط الحروف المجاورة بنفس التنسيق. ملاحظة: قد تتأثر دقة عرض المحتوى إذا تم تعيين هذه الخاصية علىحقيقي . الافتراضي هوحقيقي .
PageHorizontalAlignment { get; set; }يحدد المحاذاة الأفقية للصفحات في مستند HTML. القيمة الافتراضية هيCenter .
PageMargins { get; set; }يحدد الهوامش حول الصفحات في مستند HTML. يتم قياس قيمة الهوامش بالنقاط ويجب أن تكون مساوية أو أكبر من 0. القيمة الافتراضية هي 10 نقاط.
PageSavingCallback { get; set; }يسمح بالتحكم في كيفية حفظ الصفحات المنفصلة عند تصدير مستند إلى تنسيق الصفحة الثابتة.
PageSet { get; set; }يحصل على الصفحات التي سيتم عرضها أو يعينها. الافتراضي هو كل الصفحات الموجودة في المستند.
PrettyFormat { get; set; }عندماحقيقي ، تنسيقات الإخراج الجميلة حيثما ينطبق ذلك. القيمة الافتراضية هيخطأ شنيع .
ProgressCallback { get; set; }يتم استدعاؤها أثناء حفظ المستند وتقبل البيانات حول تقدم الحفظ.
RemoveJavaScriptFromLinks { get; set; }يحدد ما إذا كان سيتم إزالة JavaScript من الروابط. الافتراضي هوخطأ شنيع .
ResourceSavingCallback { get; set; }يسمح بالتحكم في كيفية حفظ الموارد (الصور والخطوط وCSS) عند تصدير مستند إلى تنسيق HTML لصفحة ثابتة.
ResourcesFolder { get; set; }يحدد المجلد الفعلي الذي يتم حفظ الموارد فيه (الصور والخطوط وCSS) عند تصدير مستند إلى تنسيق Html. الافتراضي هوباطل .
ResourcesFolderAlias { get; set; }يحدد اسم المجلد المستخدم لإنشاء عناوين URI للصور المكتوبة في مستند HTML. الافتراضي هوباطل .
SaveFontFaceCssSeparately { get; set; }يشير العلم إلى ما إذا كان يجب وضع قواعد CSS “@font-face” في ملف منفصل “fontFaces.css” عند حفظ مستند باستخدام جدول أنماط خارجي (أي عندماExportEmbeddedCss هوخطأ شنيع ). القيمة الافتراضية هيخطأ شنيع ، تتم كتابة جميع قواعد CSS في ملف واحد “styles.css”.
override SaveFormat { get; set; }يحدد التنسيق الذي سيتم حفظ المستند به إذا تم استخدام كائن خيارات الحفظ هذا. لا يمكن أن يكون إلاHtmlFixed .
ShowPageBorder { get; set; }يحدد ما إذا كان يجب إظهار الحدود حول الصفحات. الافتراضي هوحقيقي .
TempFolder { get; set; }يحدد المجلد للملفات المؤقتة المستخدمة عند الحفظ في ملف DOC أو DOCX. بشكل افتراضي، تكون هذه الخاصيةباطل ولا يتم استخدام أي ملفات مؤقتة.
UpdateAmbiguousTextFont { get; set; }يحدد ما إذا كانت سمات الخط ستتغير وفقًا لرمز الحرف المستخدم.
UpdateCreatedTimeProperty { get; set; }يحصل على قيمة أو يعينها لتحديد ما إذا كانCreatedTime يتم تحديث الخاصية قبل الحفظ. القيمة الافتراضية هيخطأ شنيع ;
UpdateFields { get; set; }يحصل على قيمة أو يعينها لتحديد ما إذا كان يجب تحديث حقول أنواع معينة قبل حفظ المستند بتنسيق صفحة ثابت. القيمة الافتراضية لهذه الخاصية هيحقيقي .
UpdateLastPrintedProperty { get; set; }يحصل على قيمة أو يعينها لتحديد ما إذا كانLastPrinted يتم تحديث الخاصية قبل الحفظ.
UpdateLastSavedTimeProperty { get; set; }يحصل على قيمة أو يعينها لتحديد ما إذا كانLastSavedTime يتم تحديث الخاصية قبل الحفظ.
UseAntiAliasing { get; set; }يحصل على قيمة أو يعينها لتحديد ما إذا كان سيتم استخدام التنعيم للرسم أم لا.
UseHighQualityRendering { get; set; }يحصل على قيمة أو يعينها لتحديد ما إذا كان سيتم استخدام خوارزميات عرض عالية الجودة (أي بطيئة) أم لا.
UseTargetMachineFonts { get; set; }يشير العلم إلى ما إذا كان يجب استخدام الخطوط من الجهاز المستهدف لعرض المستند. إذا تم تعيين هذا العلم علىحقيقي ،FontFormat وExportEmbeddedFonts الخصائص ليس لها تأثير، أيضًاResourceSavingCallback لا يتم تشغيله للخطوط. الافتراضي هوخطأ شنيع .

طُرق

اسموصف
override Equals(object)يحدد ما إذا كان الكائن المحدد يساوي في القيمة الكائن الحالي.

أمثلة

يوضح كيفية استخدام معاودة الاتصال لطباعة عناوين URI للموارد الخارجية التي تم إنشاؤها أثناء تحويل مستند إلى HTML.

public void HtmlFixedResourceFolder()
{
    Document doc = new Document(MyDir + "Rendering.docx");

    ResourceUriPrinter callback = new ResourceUriPrinter();

    HtmlFixedSaveOptions options = new HtmlFixedSaveOptions
    {
        SaveFormat = SaveFormat.HtmlFixed,
        ExportEmbeddedImages = false,
        ResourcesFolder = ArtifactsDir + "HtmlFixedResourceFolder",
        ResourcesFolderAlias = ArtifactsDir + "HtmlFixedResourceFolderAlias",
        ShowPageBorder = false,
        ResourceSavingCallback = callback
    };

    // سيحتوي المجلد المحدد بواسطة ResourcesFolderAlias على الموارد بدلاً من ResourcesFolder.
    // يتعين علينا التأكد من وجود المجلد قبل أن تتمكن التدفقات من وضع مواردها فيه.
    Directory.CreateDirectory(options.ResourcesFolderAlias);

    doc.Save(ArtifactsDir + "HtmlFixedSaveOptions.HtmlFixedResourceFolder.html", options);

    Console.WriteLine(callback.GetText());

    string[] resourceFiles = Directory.GetFiles(ArtifactsDir + "HtmlFixedResourceFolderAlias");

    Assert.False(Directory.Exists(ArtifactsDir + "HtmlFixedResourceFolder"));
    Assert.AreEqual(6, resourceFiles.Count(f => f.EndsWith(".jpeg") || f.EndsWith(".png") || f.EndsWith(".css")));
}

/// <summary>
/// يقوم بحساب وطباعة عناوين URI للموارد المضمنة أثناء تحويلها إلى HTML ثابت.
/// </summary>
private class ResourceUriPrinter : IResourceSavingCallback
{
    void IResourceSavingCallback.ResourceSaving(ResourceSavingArgs args)
    {
        // إذا قمنا بتعيين اسم مستعار للمجلد في كائن SaveOptions، فسوف نتمكن من طباعته من هنا.
        mText.AppendLine($"Resource #{++mSavedResourceCount} \"{args.ResourceFileName}\"");

        string extension = Path.GetExtension(args.ResourceFileName);
        switch (extension)
        {
            case ".ttf":
            case ".woff":
            {
                // بشكل افتراضي، يستخدم 'ResourceFileUri' مجلد النظام للخطوط.
                // لتجنب المشاكل في المنصات الأخرى، يجب عليك تحديد المسار للخطوط بشكل صريح.
                args.ResourceFileUri = ArtifactsDir + Path.DirectorySeparatorChar + args.ResourceFileName;
                break;
            }
        }

        mText.AppendLine("\t" + args.ResourceFileUri);

        // إذا قمنا بتحديد مجلد في خاصية "ResourcesFolderAlias"،
        // سوف نحتاج أيضًا إلى إعادة توجيه كل مجرى لوضع موارده في هذا المجلد.
        args.ResourceStream = new FileStream(args.ResourceFileUri, FileMode.Create);
        args.KeepResourceStreamOpen = false;
    }

    public string GetText()
    {
        return mText.ToString();
    }

    private int mSavedResourceCount;
    private readonly StringBuilder mText = new StringBuilder();
}

أنظر أيضا

HtmlFixedPageHorizontalAlignment Enum HtmlMetafileFormat Enum