FindReplaceOptions

FindReplaceOptions class

يحدد خيارات عمليات البحث/الاستبدال.

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

public class FindReplaceOptions

المنشئون

اسموصف
FindReplaceOptions()يقوم بتهيئة مثيل جديد لفئة FindReplaceOptions باستخدام الإعدادات الافتراضية.
FindReplaceOptions(FindReplaceDirection)يقوم بتهيئة مثيل جديد لفئة FindReplaceOptions بالاتجاه المحدد.
FindReplaceOptions(IReplacingCallback)يقوم بتهيئة مثيل جديد لفئة FindReplaceOptions باستخدام استدعاء الاستبدال المحدد.
FindReplaceOptions(FindReplaceDirectionIReplacingCallback)يقوم بتهيئة مثيل جديد لفئة FindReplaceOptions بالاتجاه المحدد واستدعاء الاستبدال.

الخصائص

اسموصف
ApplyFont { get; }تم تطبيق تنسيق النص على المحتوى الجديد.
ApplyParagraphFormat { get; }تم تطبيق تنسيق الفقرة على المحتوى الجديد.
Direction { get; set; }يحدد اتجاه الاستبدال. القيمة الافتراضية هيForward .
FindWholeWordsOnly { get; set; }يشير True إلى أن oldValue يجب أن تكون كلمة مستقلة.
IgnoreDeleted { get; set; }يحصل على قيمة منطقية أو يعينها للإشارة إلى تجاهل النص داخل مراجعات الحذف. القيمة الافتراضية هيخطأ شنيع .
IgnoreFieldCodes { get; set; }يحصل على قيمة منطقية أو يعينها للإشارة إلى تجاهل النص داخل أكواد الحقول. القيمة الافتراضية هيخطأ شنيع .
IgnoreFields { get; set; }يحصل على قيمة منطقية أو يعينها للإشارة إلى تجاهل النص داخل الحقول. القيمة الافتراضية هيخطأ شنيع .
IgnoreFootnotes { get; set; }يحصل على قيمة منطقية أو يعينها للإشارة إلى تجاهل الحواشي السفلية. القيمة الافتراضية هيخطأ شنيع .
IgnoreInserted { get; set; }يحصل على قيمة منطقية أو يعينها للإشارة إلى تجاهل النص داخل مراجعات الإدراج. القيمة الافتراضية هيخطأ شنيع .
IgnoreShapes { get; set; }يحصل على قيمة منطقية أو يعينها للإشارة إلى تجاهل الأشكال داخل النص.
IgnoreStructuredDocumentTags { get; set; }يحصل على قيمة منطقية أو يعينها للإشارة إلى تجاهل محتوىStructuredDocumentTag . القيمة الافتراضية هيخطأ شنيع .
LegacyMode { get; set; }يحصل على قيمة منطقية أو يعينها للإشارة إلى استخدام خوارزمية البحث/الاستبدال القديمة.
MatchCase { get; set; }يشير True إلى مقارنة حساسة لحالة الأحرف، ويشير false إلى مقارنة غير حساسة لحالة الأحرف.
ReplacementFormat { get; set; }يُحدد تنسيق الاستبدال. الافتراضي هوText .
ReplacingCallback { get; set; }الطريقة المحددة من قبل المستخدم والتي يتم استدعاؤها قبل كل عملية استبدال.
SmartParagraphBreakReplacement { get; set; }يحصل على قيمة منطقية أو يعينها تشير إلى أنه مسموح له باستبدال الفقرة break عندما لا تكون هناك فقرة شقيقة تالية.
UseLegacyOrder { get; set; }يشير True إلى أن البحث عن النص يتم بشكل تسلسلي من الأعلى إلى الأسفل مع مراعاة مربعات النص. القيمة الافتراضية هيخطأ شنيع .
UseSubstitutions { get; set; }يحصل على قيمة منطقية أو يعينها للإشارة إلى ما إذا كان سيتم التعرف على الاستبدالات واستخدامها داخل أنماط الاستبدال. القيمة الافتراضية هيخطأ شنيع .

أمثلة

يوضح كيفية تبديل حساسية الحالة عند إجراء عملية البحث والاستبدال.

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

builder.Writeln("Ruby bought a ruby necklace.");

// يمكننا استخدام الكائن "FindReplaceOptions" لتعديل عملية البحث والاستبدال.
FindReplaceOptions options = new FindReplaceOptions();

// اضبط علامة "MatchCase" على "true" لتطبيق حساسية الحالة أثناء البحث عن السلاسل التي يجب استبدالها.
// اضبط علامة "MatchCase" على "false" لتجاهل حالة الأحرف أثناء البحث عن نص لاستبداله.
options.MatchCase = matchCase;

doc.Range.Replace("Ruby", "Jade", options);

Assert.AreEqual(matchCase ? "Jade bought a ruby necklace." : "Jade bought a Jade necklace.",
    doc.GetText().Trim());

يوضح كيفية تبديل عمليات البحث والاستبدال الخاصة بالكلمات المستقلة فقط.

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

builder.Writeln("Jackson will meet you in Jacksonville.");

// يمكننا استخدام الكائن "FindReplaceOptions" لتعديل عملية البحث والاستبدال.
FindReplaceOptions options = new FindReplaceOptions();

// اضبط علامة "FindWholeWordsOnly" على "true" لاستبدال النص الموجود إذا لم يكن جزءًا من كلمة أخرى.
// اضبط علامة "FindWholeWordsOnly" على "false" لاستبدال كل النص بغض النظر عن محيطه.
options.FindWholeWordsOnly = findWholeWordsOnly;

doc.Range.Replace("Jackson", "Louis", options);

Assert.AreEqual(
    findWholeWordsOnly ? "Louis will meet you in Jacksonville." : "Louis will meet you in Louisville.",
    doc.GetText().Trim());

أنظر أيضا