ITextRange::FindTextStart method (tom.h)
Searches up to Count characters for the string, bstr, starting at the range's Start cp (cpFirst). The search is subject to the comparison parameter, Flags. If the string is found, the Start cp is changed to the matched string, and pLength is set equal to the length of the string. If the string is not found, the range is unchanged, and pLength is set equal to zero.
Syntax
HRESULT FindTextStart(
BSTR bstr,
long Count,
long Flags,
long *pLength
);
Parameters
bstr
Type: BSTR
The string to search for.
Count
Type: long
Maximum number of characters to search. It can be one of the following.
| tomForward | Search to the end of the story. This is the default value. |
| n (greater than 0) | Search forward for n chars, starting from cpLim. |
| n (less than 0) | Search backward for n chars, starting from cpLim. |
Flags
Type: long
Flags governing the comparisons. It can be zero (the default) or any combination of the following values.
| tomMatchWord | 2 | Matches whole words. |
| tomMatchCase | 4 | Matches case. |
| tomMatchPattern | 8 | Matches regular expressions. |
pLength
Type: long*
The length of the matched string.
Return value
Type: HRESULT
The method returns an HRESULT value. If the method succeeds, it returns S_OK. If the method fails, it returns S_FALSE.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | tom.h |
| DLL | Msftedit.dll |
See also
Conceptual
Reference