Replace 方法 (Selection 对象)¶
在文档中替换一个字符串。 strFind 指定一个要搜索的字符串。如果指定 eeExFindNumberRange，此字符串是以区间表示的数字范围。 strReplace 指定要替换为的字符串。 nFlags 指定一个下列值的组合: eeFindAround 到达文档末尾时，移至文档开头再搜索。 eeFindExtract 如果在 nExFlags 中未指定 eeExFindInsertColumn，则此方法使用正则表达式将查找结果提取到新文档中。eeFindReplaceRegExp 必须在 nFlags 中指定，并且 strReplace 不能为空。 eeFindMatchDotNL 正则表达式 "." 匹配换行符。 eeFindOutput 将提取结果显示为输出栏中的列表。必须与 eeFindExtract 结合使用。 eeFindReplaceCase 大小写需符合。 eeFindReplaceEmbeddedNL 在 CSV 文档中只匹配嵌入式换行，不匹配其他换行。 eeFindReplaceEscSeq 使用转义序列。不能与 eeFindReplaceRegExp 联用。 eeFindReplaceOnlyWord 匹配整个单词。 eeFindReplaceOpenDoc 在同一个框架窗口中，搜索所有打开的文档。 eeFindReplaceQuiet 状态栏上不显示消息如果没有找到任何字符串的话。 eeFindReplaceRegExp 为 strFind 用正则表达式。不能与 eeFindReplaceEscSeq 联用。如果此标志与 eeFindExtract 联用，则生成的匹配项将被替换为 strReplace。 eeFindReplaceSelOnly 仅在选区内搜索。 eeFindSaveHistory 为重复搜索保存搜索过的字符串。 eeReplaceAll 立即替换全部。 eeReplaceSelOnly 仅替换选定内容。 nExFlags 指定一个下列值的组合。但是，eeExFindRegexBoost，eeExFindRegexOnigmo 和 eeExFindRegexOnigmoPerl 中只能指定一个。如果不指定，那么会使用默认的正则表达式引擎。 eeExFindBOL 正则表达式 ‘^’ 可匹配选取部分的开头。 eeExFindEOL 正则表达式 ‘$’ 可匹配选取部分的末尾。 eeExFindFuzzy 使用模糊匹配。 eeExFindInsertColumn 为提取的列创建新的 CSV 列。必须在 nFlags 中指定 eeFindExtract。新列将插入在原始列的右侧。 eeExFindLookaround 只在选区内进行正则表达式搜索时用前后断言。 eeExFindNumberRange 匹配 数字范围表达式。此标志不能与 eeFindReplaceEscSeq 或 eeFindReplaceRegExp 合用。 eeExFindRegexBoost 把 Boost.Regex 作为正则表达式引擎。不能与 eeExFindRegexOnigmo 或 eeExFindRegexOnigmoPerl 联用。 eeExFindRegexOnigmo 把 Onigmo 作为正则表达式引擎，Ruby 语法。 eeExFindRegexOnigmoPerl 使用 Onigmo 作为正则表达式引擎，Perl 语法。 eeExFindSeparateCRLF 区分 CR 和 LF。 如果指定 eeReplaceAll，返回被替换的字符串数。否则，返回 1 如果找到，或 0 如果没有找到。 支持 EmEditor 4.00 或之后的版本。¶
[JavaScript]¶
nFound = document.selection.Replace( strFind, strReplace,
nFlags );
[VBScript]¶
nFound = document.selection.Replace( strFind, strReplace,
nFlags )
参数¶
如果在 nExFlags 中指定 eeExFindInsertColumn，则 CSV 文档必须处于活动状态，并且一个 或更多列必须被选择。此外，如果在 nFlags 中未指定 eeFindReplaceRegExp，则该方法将插入具有匹配字符串的新列。如果在 nFlags 中指定了 eeFindReplaceRegExp，则该方法将使用正则表达式插入带有替换表达式的新列。返回值¶
版本¶