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 是連結檔案的檔案路徑，該連結檔案包含多個由換行符分隔的搜索字串。如果一行中包含 Tab，則搜索字串是第一個不包含 Tab的字串。 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 或之後的版本。