Find Method


Searches the text in a RichTextBox control for a given string.

Syntax

object.Find(string, start, end, options)

The Find method syntax has these parts:

Part Description
object Required. Anobject expression that evaluates to an object in the Applies To list.
string Required. Astring expression you want to find in the control.
start Optional. An integer character index that determines where to begin the search. Each character in the control has an integer index that uniquely identifies it. The first character of text in the control has an index of 0.
end Optional. An integer character index that determines where to end the search.
options Optional. One or more constants used to specify optional features, as described in Settings.


Settings

The setting for options can include:

Constant Value Description
rtfWholeWord 2 Determines if a match is based on a whole word or a fragment of a word.
rtfMatchCase 4 Determines if a match is based on the case of the specified string as well as the text of the string.
rtfNoHighlight 8 Determines if a match appears highlighted in the RichTextBox control.


You can combine multiple options by using the Or operator.

Remarks

If the text searched for is found, the Find method highlights the specified text and returns the index of the first character highlighted. If the specified text is not found, the Find method returns –1.

If you use the Find method without the rtfNoHighlight option while the HideSelection property is True and the RichTextBox control does not have the focus, the control still highlights the found text. Subsequent uses of the Find method will search only for the highlighted text until the insertion point moves.