EM_FINDTEXTEX message
Finds text within a rich edit control.
Parameters
-
wParam
-
Specifies the behavior of the search operation. This parameter can be one or more of the following values.
Value Meaning - FR_DOWN
Microsoft Rich Edit 2.0 and later: If set, the search is forward from FINDTEXTEX.chrg.cpMin; if not set, the search is backward from FINDTEXTEX.chrg.cpMin.
Microsoft Rich Edit 1.0: The FR_DOWN flag is ignored. The search is always forward.- FR_MATCHALEFHAMZA
Microsoft Rich Edit 3.0 and later: If set, the search differentiates between Arabic and Hebrew alefs with different accents. If not set, all alefs are matched by the alef character alone. - FR_MATCHCASE
If set, the search operation is case-sensitive. If not set, the search operation is case-insensitive. - FR_MATCHDIAC
Microsoft Rich Edit 3.0 and later: If set, the search operation considers Arabic and Hebrew diacritical marks. If not set, diacritical marks are ignored. - FR_MATCHKASHIDA
Microsoft Rich Edit 3.0 and later: If set, the search operation considers Arabic and Hebrew kashidas. If not set, kashidas are ignored. - FR_WHOLEWORD
If set, the operation searches only for whole words that match the search string. If not set, the operation also searches for word fragments that match the search string. -
lParam
-
A FINDTEXTEX structure containing information about the find operation.
Return value
If the target string is found, the return value is the zero-based position of the first character of the match. If the target is not found, the return value is -1.
Remarks
Use this message to find ANSI strings. For Unicode, use EM_FINDTEXTEXW.
The cpMin member of FINDTEXTEX.chrg always specifies the starting-point of the search, and cpMax specifies the end point. When searching backward, cpMin must be equal to or greater than cpMax. When searching forward, a value of -1 in cpMax extends the search range to the end of the text.
If the search operation finds a match, the chrgText member of the FINDTEXTEX structure returns the range of character positions that contains the matching text.
Requirements
Requirement | Value |
---|---|
Minimum supported client |
Windows Vista [desktop apps only] |
Minimum supported server |
Windows Server 2003 [desktop apps only] |
Header |
|