FILTER_INFO_EX¶
用于 EE_FILTER 和 EE_GET_FILTER 消息。
typedef struct _FILTER_INFO_EX {
UINT cbSize;
UINT64 flags;
int iColumn;
LPWSTR pszFilter;
INT_PTR xBegin;
INT_PTR xEnd;
UINT cchFilter;
int nVisibleLinesAbove;
int nVisibleLinesBelow;
} FILTER_INFO_EX;
字段¶
cbSize
指定这个结构的大小,sizeof( FILTER_INFO_EX )。
flags
指定一个下列值的组合。
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_ONLY,FLAG_FIND_CR_LF,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_FILTER_BEGIN | 指定一个开始筛选。此标志不能与 FLAG_FILTER_END 合用。 |
FLAG_FILTER_END | 指定一个结束筛选。此标志不能与 FLAG_FILTER_BEGIN 合用。 |
iColumn
指定你想要搜索的文本的列索引,或指定 -1 如果你想要搜索整行。如果你要用字符数把开始以及结束的文本指定为 xBegin 和 xEnd,可以指定 -2。
pszFilter
指定一个要搜索的字符串。
xBegin
指定你想要搜索的文本的起始列的索引(用逻辑字符数);你也可以指定 -1 如果你想要把文本的最后一部分作为 xEnd。要使这个字段有效, iColumn 值必须是 -2。
xEnd
指定你想要搜索的文本的末尾列的索引(用逻辑字符数);你也可以指定 -1 如果你想要搜索所有剩下的文本。要使这个字段有效, iColumn 值必须是 -2。
cchFilter
为要检索的字符串,用字符数指定缓冲大小。
nVisibleLinesAbove
指定要在匹配行上方显示的额外的可见行数。如果指定了 -1,则使用先前使用的值。
nVisibleLinesBelow
指定要在匹配行下方显示的额外的可见行数。如果指定了 -1,则使用先前使用的值。
版本¶
支持 EmEditor Professional 16.0 或之后的版本。