ChmLoadOptions

ChmLoadOptions class

يسمح بتحديد خيارات إضافية عند تحميل مستند CHM فيDocument الكائن.

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

public class ChmLoadOptions : LoadOptions

المنشئون

اسموصف
ChmLoadOptions()يقوم بتهيئة مثيل جديد لهذه الفئة بالقيم الافتراضية.

الخصائص

اسموصف
BaseUri { get; set; }يحصل على السلسلة التي سيتم استخدامها لتحويل عناوين URI النسبية الموجودة في المستند إلى عناوين URI مطلقة عند الحاجة إليها أو يعينها. يمكن أن يكونباطل أو سلسلة فارغة. الافتراضي هوباطل .
ConvertMetafilesToPng { get; set; }يحصل على أو يحدد ما إذا كان سيتم تحويل الملف التعريفي (Wmf أوEmf ) الصور إلىPngتنسيق الصورة.
ConvertShapeToOfficeMath { get; set; }يحصل على أو يحدد ما إذا كان سيتم تحويل الأشكال باستخدام EquationXML إلى كائنات Office Math.
Encoding { get; set; }يحصل على أو يعين الترميز الذي سيتم استخدامه لتحميل مستند HTML أو TXT أو CHM إذا لم يتم تحديد الترميز داخل المستند. يمكن أن يكونباطل . الافتراضي هوباطل .
FontSettings { get; set; }يسمح بتحديد إعدادات خط المستند.
IgnoreOleData { get; set; }يحدد ما إذا كان سيتم تجاهل بيانات OLE.
LanguagePreferences { get; }يحصل على تفضيلات اللغة التي سيتم استخدامها عند تحميل المستند.
LoadFormat { get; set; }يحدد تنسيق المستند الذي سيتم تحميله. الافتراضي هوAuto .
MswVersion { get; set; }يسمح بتحديد أن عملية تحميل المستند يجب أن تتطابق مع إصدار MS Word محدد. القيمة الافتراضية هيWord2019
OriginalFileName { get; set; }اسم ملف CHM. القيمة الافتراضية هيباطل .
Password { get; set; }يحصل على كلمة المرور لفتح مستند مشفر أو يعينها. يمكن أن يكونباطل أو سلسلة فارغة. الافتراضي هوباطل .
PreserveIncludePictureField { get; set; }يحصل على أو يعين ما إذا كان سيتم الاحتفاظ بحقل INCLUDEPICTURE عند قراءة تنسيقات Microsoft Word. القيمة الافتراضية هيخطأ شنيع .
ProgressCallback { get; set; }يتم استدعاؤها أثناء تحميل مستند وتقبل البيانات حول تقدم التحميل.
ResourceLoadingCallback { get; set; }يسمح بالتحكم في كيفية تحميل الموارد الخارجية (الصور، أوراق الأنماط) عند استيراد مستند من HTML، MHTML.
TempFolder { get; set; }يسمح باستخدام الملفات المؤقتة عند قراءة المستند. بشكل افتراضي، هذه الخاصية هيباطل ولا يتم استخدام أي ملفات مؤقتة.
UpdateDirtyFields { get; set; }يحدد ما إذا كان سيتم تحديث الحقول باستخداممتسخ السمة.
UseSystemLcid { get; set; }يحصل على أو يحدد ما إذا كان سيتم استخدام قيمة LCID التي تم الحصول عليها من سجل Windows لتحديد هوامش إعداد الصفحة الافتراضية.
WarningCallback { get; set; }يتم استدعاؤها أثناء عملية التحميل، عند اكتشاف مشكلة قد تؤدي إلى فقدان دقة البيانات أو التنسيق.

طُرق

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

أمثلة

يوضح كيفية حل عناوين URL مثل “ms-its:myfile.chm::/index.htm”.

// تحتوي مستندنا على عناوين URL مثل "ms-its:amhelp.chm::....htm"، ولكن لها اسم مختلف،
// لذلك فإن روابط الملف لا تعمل بعد حفظه في HTML.
// نحتاج إلى تحديد اسم الملف الأصلي في 'ChmLoadOptions' لتجنب هذا السلوك.
ChmLoadOptions loadOptions = new ChmLoadOptions { OriginalFileName = "amhelp.chm" };

Document doc = new Document(new MemoryStream(File.ReadAllBytes(MyDir + "Document with ms-its links.chm")),
    loadOptions);

doc.Save(ArtifactsDir + "ExChmLoadOptions.OriginalFileName.html");

أنظر أيضا