System.Windows.Forms.RichTextBox.Find Method

Searches the text of a System.Windows.Forms.RichTextBox control, at a specific starting point, for the first instance of a character from a list of characters.

Syntax

public int Find (char[] characterSet, int start)

Parameters

characterSet
The array of characters to search for.
start
The location within the control's text at which to begin searching.

Returns

The location within the control where the search characters are found.

Remarks

This version of the RichTextBox.Find(string) method searches for the first instance of a character from a list of characters specified in the characterSet parameter and returns the location the character. For example, you pass an array of characters containing the character 'Q'. If the control contained the text "The Quick Brown Fox", the RichTextBox.Find(string) method would return the value of four. An upper case character and a lower case character are considered different values in the search.

If the property returns a negative value, the characters being searched for were not found within the contents of the control. You can use this method to search for a group of characters within the control. If a character from the character list provided in the method's characterSet parameter is found, the value returned by this method is a zero-based index of the character's position in the control. A space is considered a character by the method when determining the location of a character.

This version of the RichTextBox.Find(string) method enables you to search for a character set from a specified start position within the text of the control by specifying a value for the start parameter. A value of zero indicates that the search should start from the beginning of the control's document. You can use this version of the RichTextBox.Find(string) method to narrow your search to avoid text that you already know does not contain the specified characters you are searching for or are not important in your search.

Requirements

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0