RichTextBox コントロールのテキスト範囲内で、文字リストに含まれる文字のうち、最初に見つかる文字を検索します。
Overloads Public Function Find( _
ByVal characterSet() As Char, _ ByVal start As Integer, _ ByVal end As Integer _) As Integer
[C#]
public int Find(char[] characterSet,intstart,intend);
[C++]
public: int Find(__wchar_tcharacterSet __gc[],intstart,intend);
[JScript]
public function Find(
characterSet : Char[],start : int,end : int) : int;
パラメータ
- characterSet
検索対象の文字の配列。 - start
コントロールのテキスト内で検索を開始する位置。 - end
コントロールのテキスト内で検索を終了する位置。
戻り値
コントロール内の検索文字が見つかった位置。
例外
| 例外の種類 | 条件 |
|---|---|
| ArgumentNullException | characterSet が null です。 |
| ArgumentException | start が 0 未満か、コントロール内のテキストの長さを超える値です。 |
解説
このバージョンの Find メソッドは、 characterSet パラメータに指定されている文字リストの文字を検索し、最初に見つかった文字の位置を返します。たとえば、文字 'Q' を含む文字の配列を渡したとします。コントロールに "The Quick Brown Fox" というテキストが格納されている場合、 Find メソッドは 4 の値を返します。検索では、大文字と小文字は別の値と見なされます。
プロパティが負の値を返す場合は、検索対象の文字がコントロールの内容の中には見つからなかったことを示します。このメソッドを使用して、コントロール内で文字のグループを検索できます。メソッドの characterSet パラメータに指定されている文字リストの文字が見つかった場合、このメソッドは、その文字のコントロール内での位置を 0 から始まるインデックスで返します。このメソッドが文字の位置を判断するときは、空白も文字であると見なされます。
このバージョンの Find メソッドを使用し、start パラメータおよび end パラメータに値を指定することによって、コントロール内のテキスト範囲内で文字セットを検索できます。start パラメータの値が 0 の場合は、コントロール内のドキュメントの先頭から検索を開始することを示します。 end パラメータの値が -1 の場合は、コントロール内のテキストの末尾で検索を終了することを示します。このバージョンの Find メソッドを使用して、アプリケーションにとって重要でないドキュメント部分を検索対象から外し、検索範囲を特定のテキスト範囲に絞り込むことができます。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
参照
RichTextBox クラス | RichTextBox メンバ | System.Windows.Forms 名前空間 | RichTextBox.Find オーバーロードの一覧