RtfLoadOptions

RtfLoadOptions class

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

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

public class RtfLoadOptions : LoadOptions

المنشئون

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

الخصائص

اسموصف
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
Password { get; set; }يحصل على كلمة المرور لفتح مستند مشفر أو يعينها. يمكن أن يكونباطل أو سلسلة فارغة. الافتراضي هوباطل .
PreserveIncludePictureField { get; set; }يحصل على أو يعين ما إذا كان سيتم الاحتفاظ بحقل INCLUDEPICTURE عند قراءة تنسيقات Microsoft Word. القيمة الافتراضية هيخطأ شنيع .
ProgressCallback { get; set; }يتم استدعاؤها أثناء تحميل مستند وتقبل البيانات حول تقدم التحميل.
RecognizeUtf8Text { get; set; }عند ضبطه علىحقيقي ، سيحاول اكتشاف أحرف UTF8، سيتم الاحتفاظ بها أثناء الاستيراد.
ResourceLoadingCallback { get; set; }يسمح بالتحكم في كيفية تحميل الموارد الخارجية (الصور، أوراق الأنماط) عند استيراد مستند من HTML، MHTML.
TempFolder { get; set; }يسمح باستخدام الملفات المؤقتة عند قراءة المستند. بشكل افتراضي، هذه الخاصية هيباطل ولا يتم استخدام أي ملفات مؤقتة.
UpdateDirtyFields { get; set; }يحدد ما إذا كان سيتم تحديث الحقول باستخداممتسخ السمة.
UseSystemLcid { get; set; }يحصل على أو يحدد ما إذا كان سيتم استخدام قيمة LCID التي تم الحصول عليها من سجل Windows لتحديد هوامش إعداد الصفحة الافتراضية.
WarningCallback { get; set; }يتم استدعاؤها أثناء عملية التحميل، عند اكتشاف مشكلة قد تؤدي إلى فقدان دقة البيانات أو التنسيق.

طُرق

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

أمثلة

يوضح كيفية اكتشاف أحرف UTF-8 أثناء تحميل مستند RTF.

// قم بإنشاء كائن "RtfLoadOptions" لتعديل كيفية تحميل مستند RTF.
RtfLoadOptions loadOptions = new RtfLoadOptions();

// اضبط خاصية "RecognizeUtf8Text" على "false" لافتراض أن المستند يستخدم مجموعة أحرف ISO 8859-1
// ويحمل كل حرف في المستند.
// قم بضبط الخاصية "RecognizeUtf8Text" على "true" لتحليل أي أحرف ذات طول متغير قد تظهر في النص.
loadOptions.RecognizeUtf8Text = recognizeUtf8Text;

Document doc = new Document(MyDir + "UTF-8 characters.rtf", loadOptions);

Assert.AreEqual(
    recognizeUtf8Text
        ? "“John Doe´s list of currency symbols”™\r" +
          "€, ¢, £, ¥, ¤"
        : "“John Doe´s list of currency symbolsâ€\u009dâ„¢\r" +
          "€, ¢, £, ¥, ¤",
    doc.FirstSection.Body.GetText().Trim());

أنظر أيضا