IMarkupPointer::FindText Method

Searches for specified text, from the current pointer's position to another pointer's position.

Syntax


HRESULT FindText(
    OLECHAR *pchFindText,
    DWORD dwFlags,
    IMarkupPointer *pIEndMatch,
    IMarkupPointer *pIEndSearch
);

Parameters

pchFindText
[in] Pointer to an OLECHAR structure that specifies the byte string to find.
dwFlags
[in]  One of the following required values:
FINDTEXT_BACKWARDS
Find previous matches.
FINDTEXT_WHOLEWORD
Match whole words only.
FINDTEXT_MATCHCASE
Match capitalization. Default is to ignore case.
FINDTEXT_RAW
Treats characters outside the ASCII range as binary. Overrides behavior specified with the following flags.
FINDTEXT_MATCHREPEATEDWHITESPACE New for Windows Internet Explorer 9 
Internet Explorer 9. Treat multiple whitespace characters (0x09-0x0D or 0x20) as a single character. Available only in IE9 Standards mode and later.
FINDTEXT_MATCHDIAC
Match diacritical marks. Default is to ignore.
FINDTEXT_MATCHKASHIDA
Match kashida spaces. Default is to ignore.
FINDTEXT_MATCHALEFHAMZA
Match unadorned alef to character variants. Default is not to match.
pIEndMatch
[in] Pointer to an IMarkupPointer interface that specifies the position of the last match, or NULL to search from the current document position. The search operation updates the position of pIEndMatch if a match is found.
pIEndSearch
[in] Pointer to an IMarkupPointer interface that specifies the end point of the search operation, or NULL to search to the beginning or end of the document. The direction of the search (FINDTEXT_BACKWARDS) is inferred based on whether the end point is before or after the current document position.

Return Value

Returns one of the following, or an error otherwise.

S_OK A match was found.
S_FALSE A match was not found.
Show: