FindReplaceOptions
内容
[
隐藏
]FindReplaceOptions class
指定查找/替换操作的选项。
要了解更多信息，请访问查找和替换文档文章。
public class FindReplaceOptions
构造函数
| 姓名 | 描述 |
|---|---|
| FindReplaceOptions() | 使用默认设置初始化 FindReplaceOptions 类的新实例。 |
| FindReplaceOptions(FindReplaceDirection) | 使用指定的方向初始化 FindReplaceOptions 类的新实例。 |
| FindReplaceOptions(IReplacingCallback) | 使用指定的替换回调初始化 FindReplaceOptions 类的新实例。 |
| FindReplaceOptions(FindReplaceDirection, IReplacingCallback) | 使用指定的方向和替换回调初始化 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());
