Editor_Filter¶
用指定的字符串以及设定来筛选文档。你能用这个内联函数或明确地发送 EE_FILTER 消息。
Editor_Filter( HWND hwnd, LPCWSTR szFilter, int iColumn, UINT nFlags,
INT_PTR xBegin, INT_PTR xEnd ); hwnd 指定 EmEditor 视图或框架的窗口句柄。 szFilter 指定一个要搜索的字符串。 iColumn 指定你想要搜索的文本的列索引,或指定 -1 如果你想要搜索整行。 nFlags 你能指定一个下列值的组合。 FLAG_FIND_BOOKMARKED_ONLY 仅匹配书签行。此标志不能与 FLAG_FIND_UNBOOKMARKED_ONLY 合用。 FLAG_FIND_CASE 大小写需符合。 FLAG_FIND_CONTINUE 指定下次调用的 EE_FILTER 消息不清除筛选记录。此筛选在调用这个消息后不会马上应用。当你想要进行多个级别的筛选时,可以使用这个标志。它与 FLAG_FIND_KEEP_PREVIOUS 标志相同,但由于实际的筛选不会在每次调用消息时被应用,这个方法更适用于多个筛选级别。 FLAG_FIND_CR_LF 匹配换行符为 CR 和 LF 的行。此标志必须与 FLAG_FIND_MATCH_NL 合用。 FLAG_FIND_CR_ONLY 匹配换行符为仅 CR 的行。此标志必须与 FLAG_FIND_MATCH_NL 合用。 FLAG_FIND_ESCAPE 使用转义序列。 FLAG_FIND_FUZZY 使用模糊匹配。 FLAG_FIND_KEEP_PREVIOUS 指定 EE_FILTER 消息不会在应用新筛选前清除已存在的筛选记录。你可以在你要进行多个级别的筛选时,使用这个标志。 FLAG_FIND_LOGICAL_OR 指定一个逻辑或运算 (logical OR) 到之前的层级上在多层级筛选的情况下。 FLAG_FIND_LF_ONLY 匹配换行符为仅 LF 的行。此标志必须与 FLAG_FIND_MATCH_NL 合用。 FLAG_FIND_LINK_FILE 指定 pszFilter 是链接文件的文件路径,该链接文件包含多个由换行符分隔的搜索字符串。如果一行中包含制表符,则搜索字符串是第一个不包含制表符的字符串。 pszFilter 可能是 EmEditor 安装路径的相对路径。它可能包含环境变量,例如 %USERPROFILE%。 FLAG_FIND_MATCH_NL 匹配指定的换行符。此标志应与 FLAG_FIND_CR_LF,FLAG_FIND_CR_ONLY,FLAG_FIND_LF_ONLY,和/或 FLAG_FIND_NL_OTHERS 合用。 FLAG_FIND_NEGATIVE 显示筛选工具栏并排除与指定字符串匹配的行。 FLAG_FIND_NL_OTHERS 匹配没有换行符的行。这些行包括文件的最后一行以及非常长的,继续到下一行而没有换行符行。此标志必须与 FLAG_FIND_MATCH_NL 合用。 FLAG_FIND_NUMBER_RANGE 匹配数字范围。此标志不能与 FLAG_FIND_ESCAPE 或 FLAG_FIND_REG_EXP 合用。 FLAG_FIND_ONLY_WORD 整个单词需匹配。 FLAG_FIND_REG_EXP 使用一个正则表达式。 FLAG_FIND_REMOVE_LAST 删除前一次添加的筛选级别。 FLAG_FIND_UNBOOKMARKED_ONLY 仅匹配未标记书签的行。此标志不能与 FLAG_FIND_BOOKMARKED_ONLY 合用。 FLAG_FIND_WHOLE_STRING 匹配整个字符串。 xBegin 指定你想要搜索的文本的列开始的索引(用逻辑字符数);你也可以指定 -1 如果你想要把文本的最后一部分作为 xEnd。 xEnd 指定你想要搜索的文本的列结束的索引(用逻辑字符数);你也可以指定 -1 如果你想要搜索所有剩下的文本。 返回值是与指定字符串相匹配的行数。如果指定的字符串是一个空字符串,返回值是 -1。如果指定的是 FLAG_FIND_CONTINUE,返回值是 0。 支持 EmEditor Professional 14.7 或之后的版本。参数¶
返回值¶
版本¶