Find 方法 (Selection 对象)

搜索指定的字符串。

[JavaScript]

nFound = document.selection.Find( strFind, nFlags[, nExFlags] );

[VBScript]

nFound = document.selection.Find( strFind, nFlags[, nExFlags] )

参数

strFind

指定一个要搜索的字符串。如果指定 eeExFindNumberRange,此字符串是以区间表示的数字范围。

nFlags

指定一个下列值的组合:

eeFindAround

当达到文档末尾时,移动到文档的开始位置处。

eeFindBookmark

在有匹配的字符串的行上设置书签。

eeFindCount

计算匹配字符串的出现次数。

eeFindExtract

把匹配的行提取到一个新文档中。可以与 eeFindFileAndLine,eeFindFileNamesOnly,eeFindLineOnly,或 eeFindMatchedOnly 合用。如果没有与这些标志合用,会假定 eeFindLineOnly。

eeFindFileAndLine

不会在搜索结果中显示文件名,行号,以及包含搜索字符串的行。一定要与 eeFindExtract 合用。不能与 eeFindFileNamesOnly,eeFindLineOnly 或 eeFindMatchedOnly 合用。

eeFindFileNamesOnly

仅在搜索结果中显示文件名,包含搜索字符串的行不会被显示。一定要与 eeFindExtract 合用。不能与 eeFindFileAndLine,eeFindLineOnly 或 eeFindMatchedOnly 合用。

eeFindLineOnly

仅在搜索结果中显示包含搜索字符串的行。一定要与 eeFindExtract 合用。不能与 eeFindFileAndLine,eeFindMatchedOnly 或 eeFindFileNamesOnly 合用。

eeFindMatchedOnly

仅在搜索结果中显示匹配的字符串。一定要与 eeFindExtract 合用。不能与 eeFindFileAndLine,eeFindFileNamesOnly 或 eeFindLineOnly 合用。

eeFindNext

从光标处往下进行搜索。

eeFindMatchDotNL

正则表达式 "." 匹配换行符。

eeFindOutput

把提取结果显示在输出栏中。一定要与 eeFindExtract 合用。

eeFindPrevious

从光标处往上搜索字符串。

eeFindReplaceCase

大小写需符合。

eeFindReplaceEmbeddedNL

在 CSV 文档中只匹配嵌入式换行,不匹配其他换行。

eeFindReplaceEscSeq

使用转义序列。不能与 eeFindReplaceRegExp 联用。

eeFindReplaceOnlyWord

匹配整个单词。

eeFindReplaceOpenDoc

在同一个框架窗口中,搜索所有打开的文档。

eeFindReplaceQuiet

状态栏上不显示消息如果没有找到任何字符串的话。

eeFindReplaceRegExp

使用正则表达式搜索字符串。不能与 eeFindReplaceEscSeq 联用。

eeFindReplaceSelOnly

仅在选区内搜索。

eeFindSaveHistory

为重复搜索保存搜索过的字符串。

eeFindSelectAll

选择所有匹配的字符串。

nExFlags

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

eeExFindBOL

正则表达式 ‘^’ 可匹配选取部分的开头。

eeExFindCountFrequency

根据提取结果创建一个常用字符串表。必须与 eeFindExtract 和 eeFindLineOnly 或 eeFindMatchedOnly 结合使用。必须启用窗口标签页。

eeExFindEOL

正则表达式 ‘$’ 可匹配选取部分的末尾。

eeExFindFuzzy

使用模糊匹配。

eeExFindLookaround

只在选区内进行正则表达式搜索时用前后断言。

eeExFindNoOverlap

查找下一个或上一个匹配项时,不匹配重叠字符串。

eeExFindNumberRange

匹配 数字范围表达式。此标志不能与 eeFindReplaceEscSeq 或 eeFindReplaceRegExp 合用。

eeExFindRegexBoost

把 Boost.Regex 作为正则表达式引擎。

eeExFindRegexOnigmo

把 Onigmo 作为正则表达式引擎,Ruby 语法。

eeExFindRegexOnigmoPerl

使用 Onigmo 作为正则表达式引擎,Perl 语法。

eeExFindSeparateCRLF

区分 CR 和 LF。

返回值

返回 1 如果搜索字符串被找到;如果没有找到搜索字符串,则返回 0。如果 eeFindCount,eeFindBookmark,eeFindSelectAll,eeFindExtract 标志被指定,那么返回值就是文档中匹配的字符串所出现的次数。

版本

支持 EmEditor 4.00 或之后的版本。