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; }الحصول على قيمة أو تعيينها لتحديد كيفية عرض تأثيرات DrawML.
DmlRenderingMode { get; set; }الحصول على قيمة أو تعيينها لتحديد كيفية عرض أشكال DrawML.
Encoding { get; set; }يحدد الترميز الذي سيتم استخدامه عند التصدير إلى HTML. القيمة الافتراضية هيترميز UTF8 الجديد (صحيح) (UTF-8 مع قائمة مكونات الصنف).
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; }الحصول على أو تعيين الإشارة إلى ما إذا كان سيتم تصدير حقول النموذج كعناصر تفاعلية (كعلامة ‘إدخال’) بدلاً من تحويلها إلى نص أو رسومات.
ExportGeneratorName { get; set; }متىحقيقي ، يؤدي إلى تضمين اسم وإصدار Aspose.Words في الملفات المنتجة. القيمة الافتراضية هيحقيقي .
FontFormat { get; set; }يحصل على أو مجموعاتExportFontFormat يستخدم لتصدير الخط. القيمة الافتراضية هيWoff .
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; }يتم الاتصال به أثناء حفظ مستند ويقبل البيانات المتعلقة بتقدم الحفظ.
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. بشكل افتراضي، تكون هذه الخاصيةباطل ولا يتم استخدام أي ملفات مؤقتة.
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