Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

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.

ValueMeaning
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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Richedit.h

See also

EM_FINDTEXT

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.