BatchFindInFiles 方法 (Editor 对象)¶

在多个文件中搜索多个字符串。搜索文件的结果列表将显示在当前窗口中。如果未保存文档，该方法将显示是否保存文件的提示信息。

¶

nFound = editor.BatchFindInFiles( filters, strPath, nFlags, [ nEncoding, [ strFilesToIgnore, [ nExFlags, [ nLimit ] ] ] ] );

nFound = editor.BatchFindInFiles( filters, strPath, nFlags, [ nEncoding, [ strFilesToIgnore, [ nExFlags, [ nLimit ] ] ] ] )

filters

指定包含搜索字符串和标志的 Filters 集合。

strPath

指定要搜索的路径。它可以包括通配符，例如\* 以及 ?。

nFlags

指定一个下列值的组合。


eeFindOpenDirect	直接打开包含指定字符串的文档。不能与 eeFindOpenFilter 或 eeFindOutput 合用。
eeFindOpenFilter	直接打开包含指定字符串的文档，并将指定字符串设为筛选。不能与 eeFindOpenDirect 或 eeFindOutput 合用。
eeFindOutput	在输出栏中以列表形式显示“在文件中查找”结果。不能与 eeFindOpenDirect 或 eeFindOpenFilter 合用。
eeFindRecursive	在指定路径的子文件夹中搜索。
eeFindReplaceIgnoreFiles	忽略由 strFilesToIgnore 指定的文件或文件夹。
eeOpenDetectAll	检测所有编码。
eeOpenDetectCharset	检测 HTML/XML 字符集。
eeOpenDetectUnicode	检测 Unicode 签名 (BOM)。
eeOpenDetectUTF8	检测 UTF-8。

此外，您可以指定以下值之一。


eeFindFileAndMatched	搜索结果将显示文件名和匹配的字符串。
eeFindFileLineAndMatched	搜索结果将显示文件名，行号和匹配的字符串。
eeFindFileNamesOnly	搜索结果仅显示文件名，而包含搜索字符串的整行将不显示为结果。
eeFindLineOnly	搜索结果仅显示包含搜索字符串的整行。
eeFindMatchedOnly	搜索结果仅显示匹配的字符串。

nEncoding

从 编码常数 中选择或指定任何用于 Windows 操作系统的代码页。如果指定 0 或省略，将使用与搜索的文件名关联的配置属性中指定的编码。

strFilesToIgnore

如果 nFlags 包括 eeFindReplaceIgnoreFiles，指定要忽略的文件或文件夹名称。它可以包括通配符，例如 * 和 ?。要指定多个文件，用分号 (;) 来隔开文件。

nExFlags

指定下列值的组合。但是，只能指定 eeExFindRegexBoost，eeExFindRegexOnigmo 和 eeExFindRegexOnigmoPerl 中的一个。如果不指定，则使用默认的正则表达式引擎。


eeExFindCountFrequency	从提取结果中创建常用字符串列表。必须与 eeFindLineOnly 或 eeFindMatchedOnly 合用。
eeExFindMulti	执行多项查找。如果未指定，则执行批处理查找。
eeExFindOutputEncoding	将编码名称附加到文件名。
eeExFindRegexBoost	使用 Boost.Regex 作为正则表达式引擎。
eeExFindRegexOnigmo	使用 Onigmo 作为正则表达式引擎，Ruby 语法。
eeExFindRegexOnigmoPerl	使用 Onigmo 作为正则表达式引擎，Perl 语法。

nLimit

当匹配数达到此数字时，EmEditor 将停止搜索文件。如果指定 0，则 EmEditor 不会停止搜索文件。

返回值是在所有搜索的文件中包含匹配字符串的行数。

支持 EmEditor Professional 20.0 或之后的版本。