RichTextBox.Find メソッド

定義

RichTextBox の内容の中でテキストを検索します。Searches for text within the contents of the RichTextBox.

オーバーロード

Find(String, Int32, Int32, RichTextBoxFinds)

特定の検索オプションを適用し、RichTextBox コントロール内の指定したテキスト範囲内で文字列を検索します。Searches the text in a RichTextBox control for a string within a range of text within the control and with specific options applied to the search.

Find(String, Int32, RichTextBoxFinds)

特定の検索オプションを適用し、RichTextBox コントロール内のテキストで、特定の位置にある文字列を検索します。Searches the text in a RichTextBox control for a string at a specific location within the control and with specific options applied to the search.

Find(Char[], Int32, Int32)

RichTextBox コントロールのテキスト範囲内で、文字リストに含まれる文字のうち、最初に見つかる文字を検索します。Searches a range of text in a RichTextBox control for the first instance of a character from a list of characters.

Find(Char[])

RichTextBox コントロールのテキスト内で、文字リストに含まれる文字のうち、最初に見つかる文字を検索します。Searches the text of a RichTextBox control for the first instance of a character from a list of characters.

Find(Char[], Int32)

RichTextBox コントロールのテキスト内で、検索開始位置を指定して、文字リストに含まれる文字のうち最初に見つかる文字を検索します。Searches the text of a RichTextBox control, at a specific starting point, for the first instance of a character from a list of characters.

Find(String)

RichTextBox コントロール内のテキストで文字列を検索します。Searches the text in a RichTextBox control for a string.

Find(String, RichTextBoxFinds)

特定の検索オプションを適用して、RichTextBox コントロール内のテキストで文字列を検索します。Searches the text in a RichTextBox control for a string with specific options applied to the search.

Find(String, Int32, Int32, RichTextBoxFinds)

特定の検索オプションを適用し、RichTextBox コントロール内の指定したテキスト範囲内で文字列を検索します。Searches the text in a RichTextBox control for a string within a range of text within the control and with specific options applied to the search.

public:
 int Find(System::String ^ str, int start, int end, System::Windows::Forms::RichTextBoxFinds options);
public int Find (string str, int start, int end, System.Windows.Forms.RichTextBoxFinds options);
member this.Find : string * int * int * System.Windows.Forms.RichTextBoxFinds -> int
Public Function Find (str As String, start As Integer, end As Integer, options As RichTextBoxFinds) As Integer

パラメーター

str
String

コントロール内で検索するテキスト。The text to locate in the control.

start
Int32

コントロールのテキスト内で検索を開始する位置。The location within the control's text at which to begin searching.

end
Int32

コントロールのテキスト内で検索を終了する位置。The location within the control's text at which to end searching. この値は -1 または start パラメーターの値以上であることが必要です。This value must be equal to negative one (-1) or greater than or equal to the start parameter.

options
RichTextBoxFinds

RichTextBoxFinds 値のビットごとの組み合わせ。A bitwise combination of the RichTextBoxFinds values.

戻り値

Int32

コントロール内の検索文字列が見つかった位置。The location within the control where the search text was found.

例外

str パラメーターは null でした。The str parameter was null.

start パラメーターが 0 未満でした。The start parameter was less than zero.

- または --or- end パラメーターの値が start パラメーターの値未満でした。The end parameter was less the start parameter.

次のコード例では、 RichTextBox メソッドのパラメーターに渡された検索文字列の最初のインスタンスについて、内のテキストのセクションを検索し searchText ます。The following code example searches a section of text in a RichTextBox for the first instance of a search string passed into the searchText parameter of the method. コントロール内のテキストを検索する範囲は、 searchStart メソッドのパラメーターとパラメーターによって指定され searchEnd ます。The range to search for text within the control is specified by the searchStart and searchEnd parameters of the method. 検索文字列がで見つかった場合 RichTextBox 、メソッドは、見つかったテキストの最初の文字のインデックス位置を返し、見つかったテキストを強調表示します。それ以外の場合は、値-1 を返します。If the search string is found in the RichTextBox, the method returns the index location of the first character of the found text and highlights the found text; otherwise, it returns a value of -1. また、この例では、メソッドのパラメーターを使用して、 options Find 検索文字列の大文字と小文字を区別するように指定しています。The example also uses the options parameter of the Find method to specify that the found text should match the case of the search string. この例では、このメソッドが、 Form という名前のコントロールを含むのクラスに配置されている必要があり RichTextBox richTextBox1 ます。The example requires that this method is placed in the class of a Form that contains a RichTextBox control named richTextBox1. 検索文字列の最初のインスタンスが見つかったら、次の例を使用して、テキスト内の他のインスタンスを検索できます。After the first instance of the search string has been found, you can use this example to find other instances in the text.

public:
   int FindMyText( String^ searchText, int searchStart, int searchEnd )
   {
      // Initialize the return value to false by default.
      int returnValue = -1;

      // Ensure that a search string and a valid starting point are specified.
      if ( searchText->Length > 0 && searchStart >= 0 )
      {
         // Ensure that a valid ending value is provided.
         if ( searchEnd > searchStart || searchEnd == -1 )
         {
            // Obtain the location of the search string in richTextBox1.
            int indexToText = richTextBox1->Find( searchText, searchStart, searchEnd, RichTextBoxFinds::MatchCase );

            // Determine whether the text was found in richTextBox1.
            if ( indexToText >= 0 )
            {
               // Return the index to the specified search text.
               returnValue = indexToText;
            }
         }
      }

      return returnValue;
   }
public int FindMyText(string searchText, int searchStart, int searchEnd)
{
    // Initialize the return value to false by default.
    int returnValue = -1;

    // Ensure that a search string and a valid starting point are specified.
    if (searchText.Length > 0 && searchStart >= 0) 
    {
        // Ensure that a valid ending value is provided.
        if (searchEnd > searchStart || searchEnd == -1)
        {	
            // Obtain the location of the search string in richTextBox1.
            int indexToText = richTextBox1.Find(searchText, searchStart, searchEnd, RichTextBoxFinds.MatchCase);
            // Determine whether the text was found in richTextBox1.
            if(indexToText >= 0)
            {
                // Return the index to the specified search text.
                returnValue = indexToText;
            }
        }
    }

    return returnValue;
}
Public Function FindMyText(ByVal searchText As String, ByVal searchStart As Integer, ByVal searchEnd As Integer) As Integer
    ' Initialize the return value to false by default.
    Dim returnValue As Integer = -1

    ' Ensure that a search string and a valid starting point are specified.
    If searchText.Length > 0 And searchStart >= 0 Then
        ' Ensure that a valid ending value is provided.
        If searchEnd > searchStart Or searchEnd = -1 Then
            ' Obtain the location of the search string in richTextBox1.
        Dim indexToText As Integer = richTextBox1.Find(searchText, searchStart, searchEnd, RichTextBoxFinds.MatchCase)
            ' Determine whether the text was found in richTextBox1.
            If indexToText >= 0 Then
                ' Return the index to the specified search text.
                returnValue = indexToText
            End If
        End If
    End If

    Return returnValue
End Function

注釈

メソッドは、 Find パラメーターで指定されたテキストを検索 str し、コントロール内の検索文字列の最初の文字の位置を返します。The Find method searches for the text specified in the str parameter and returns the location of the first character of the search string within the control. プロパティが負の値を返す場合、検索対象のテキスト文字列がコントロールの内容内に見つかりませんでした。If the property returns a negative value, the text string being searched for was not found within the contents of the control. このメソッドを使用すると、コントロールのユーザーに提供できる検索機能を作成できます。You can use this method to create search functionality that can be provided to the user of the control. また、このメソッドを使用して、特定の形式で置き換えるテキストを検索することもできます。You can also use this method to search for text to be replaced with a specific format. たとえば、ユーザーがコントロールに日付を入力した場合は、メソッドを使用し Find て、ドキュメント内のすべての日付を検索し、適切な形式に置き換えることができます。その後、 SaveFile コントロールのメソッドを使用します。For example, if the user entered dates into the control, you can use the Find method to search for all dates in the document and replace them with the appropriate format before using the SaveFile method of the control.

このバージョンのメソッドでは Find 、検索を拡大または縮小できるようにするオプションを指定できます。With this version of the Find method, you can specify options that enable you to expand or narrow your search. 検索語の大文字と小文字の区別を一致させるオプションや、部分的な単語ではなく単語全体を検索するオプションを指定できます。You can specify options that enable you to match the casing of the search word or to search for entire words instead of partial words. パラメーターで列挙を指定することにより、 RichTextBoxFinds.Reverse options 既定の上から下への検索方法ではなく、ドキュメントの下部から一番上までのテキストを検索できます。By specifying the RichTextBoxFinds.Reverse enumeration in the options parameter, you can search for text from the bottom of the document to the top instead of the default top to bottom search method. また、このバージョンのメソッドを使用すると、 Find コントロールのテキスト内で特定の開始位置と終了位置を選択して、テキストの検索を絞り込むことができます。This version of the Find method also enables you to narrow the search for text by selecting a specific start and end position within the control's text. この機能を使用すると、検索範囲をコントロールのテキストの特定のセクションに限定することができます。This feature can enable you to limit the search range to a specific section of the control's text. 負の 1 (-1) の値がパラメーターに割り当てられている場合、 end メソッドは、通常の検索のために内のテキストの末尾まで検索 RichTextBox します。If a value of negative one (-1) is assigned to the end parameter, the method will search until the end of the text in the RichTextBox for normal searches. 逆引き検索の場合、パラメーターに割り当てられた負の 1 (-1) の値は、テキスト end がテキストの末尾 (下部) からパラメーターで定義された位置まで検索されることを示し start ます。For reverse searches, a value of negative one (-1) assigned to the end parameter indicates that text will be searched from the end of text (bottom) to the position defined by start parameter. startパラメーターとパラメーターが同じ値に指定されている場合 end 、コントロール全体で通常の検索が検索されます。When the start and end parameters are provided the same value the entire control is searched for normal searches. 逆検索では、コントロール全体が検索されますが、検索はドキュメントの一番下から開始され、ドキュメントの先頭に向かって検索されます。For a reverse search, the entire control is searched but the search begins at the bottom of the document and searches to the top of the document.

注意

Findstring パラメーターとして受け取るメソッドは、内の複数行のテキストに含まれるテキストを見つけることができません RichTextBoxThe Find methods that accept a string as a parameter cannot find text that is contained on more than one line of text within the RichTextBox. このような検索を実行すると、負の 1 (-1) の値が返されます。Performing such a search will return a value of negative one (-1).

Find(String, Int32, RichTextBoxFinds)

特定の検索オプションを適用し、RichTextBox コントロール内のテキストで、特定の位置にある文字列を検索します。Searches the text in a RichTextBox control for a string at a specific location within the control and with specific options applied to the search.

public:
 int Find(System::String ^ str, int start, System::Windows::Forms::RichTextBoxFinds options);
public int Find (string str, int start, System.Windows.Forms.RichTextBoxFinds options);
member this.Find : string * int * System.Windows.Forms.RichTextBoxFinds -> int
Public Function Find (str As String, start As Integer, options As RichTextBoxFinds) As Integer

パラメーター

str
String

コントロール内で検索するテキスト。The text to locate in the control.

start
Int32

コントロールのテキスト内で検索を開始する位置。The location within the control's text at which to begin searching.

options
RichTextBoxFinds

RichTextBoxFinds 値のビットごとの組み合わせ。A bitwise combination of the RichTextBoxFinds values.

戻り値

Int32

コントロール内の検索文字列が見つかった位置。The location within the control where the search text was found.

次のコード例では、 RichTextBox メソッドの text パラメーターに渡された検索文字列の最初のインスタンスについて、のコンテンツ全体を検索します。The following code example searches the entire contents of a RichTextBox for the first instance of a search string passed into the text parameter of the method. 検索の開始位置は、メソッドの start パラメーターによって指定されます。The search starting location is specified by the start parameter of the method. 検索文字列がで見つかった場合 RichTextBox 、メソッドは、見つかったテキストの最初の文字のインデックス位置を返し、見つかったテキストを強調表示します。それ以外の場合は、値-1 を返します。If the search string is found in the RichTextBox, the method returns the index location of the first character of the found text and highlights the found text; otherwise, it returns a value of -1. この例では、指定した検索文字列の大文字と小文字を区別するために、検索のオプションも指定します。The example also specifies options in the search to match the case of the specified search string. この例では、このメソッドが、 Form という名前のを含むのクラスに配置されている必要があり RichTextBox richTextBox1 ます。The example requires that this method is placed in the class of a Form that contains a RichTextBox named richTextBox1. この例を使用すると、"Find Next" という種類の操作を実行できます。You can use this example to perform a "Find Next" type of operation. 検索テキストのインスタンスが見つかったら、パラメーターの値を変更して、 start 現在の一致の位置を超えて位置を検索することで、テキストの他のインスタンスを見つけることができます。Once an instance of the search text has been found, you can find other instances of the text by changing the value of the start parameter to search at a location beyond the position of the current match.

public:
   int FindMyText( String^ text, int start )
   {
      // Initialize the return value to false by default.
      int returnValue = -1;
      
      // Ensure that a search string has been specified and a valid start point.
      if ( text->Length > 0 && start >= 0 )
      {
         // Obtain the location of the search string in richTextBox1.
         int indexToText = richTextBox1->Find( text, start, RichTextBoxFinds::MatchCase );
         // Determine whether the text was found in richTextBox1.
         if ( indexToText >= 0 )
         {
            returnValue = indexToText;
         }
      }

      return returnValue;
   }
public int FindMyText(string text, int start)
{
   // Initialize the return value to false by default.
   int returnValue = -1;

   // Ensure that a search string has been specified and a valid start point.
   if (text.Length > 0 && start >= 0) 
   {
      // Obtain the location of the search string in richTextBox1.
      int indexToText = richTextBox1.Find(text, start, RichTextBoxFinds.MatchCase);
      // Determine whether the text was found in richTextBox1.
      if(indexToText >= 0)
      {
         returnValue = indexToText;
      }
   }

   return returnValue;
}

Public Function FindMyText(text As String, start As Integer) As Integer
    ' Initialize the return value to false by default.
    Dim returnValue As Integer = - 1
    
    ' Ensure that a search string has been specified and a valid start point.
    If text.Length > 0 And start >= 0 Then
        ' Obtain the location of the search string in richTextBox1.
        Dim indexToText As Integer = richTextBox1.Find(text, start, _
            RichTextBoxFinds.MatchCase)
        ' Determine whether the text was found in richTextBox1.
        If indexToText >= 0 Then
            returnValue = indexToText
        End If
    End If
    
    Return returnValue
End Function

注釈

メソッドは、 Find パラメーターで指定されたテキストを検索 str し、コントロール内の検索文字列の最初の文字の位置を返します。The Find method searches for the text specified in the str parameter and returns the location of the first character of the search string within the control. プロパティが負の値を返す場合、検索対象のテキスト文字列がコントロールの内容内に見つかりませんでした。If the property returns a negative value, the text string being searched for was not found within the contents of the control. このメソッドを使用すると、コントロールのユーザーに提供できる検索機能を作成できます。You can use this method to create search functionality that can be provided to the user of the control. また、このメソッドを使用して、特定の形式で置き換えるテキストを検索することもできます。You can also use this method to search for text to be replaced with a specific format. たとえば、ユーザーがコントロールに日付を入力した場合、メソッドを使用し Find て、ドキュメント内のすべての日付を検索し、適切な形式に置き換えてから、コントロールのメソッドを使用することができ SaveFile ます。For example, if the user entered dates into the control, you could use the Find method to search for all dates in the document and replace them with the appropriate format before using the SaveFile method of the control.

このバージョンのメソッドでは Find 、検索を拡大または縮小できるようにするオプションを指定できます。With this version of the Find method, you can specify options that enable you to expand or narrow your search. 検索語の大文字と小文字の区別を一致させるオプションや、部分的な単語ではなく単語全体を検索するオプションを指定できます。You can specify options that enable you to match the casing of the search word or to search for entire words instead of partial words. パラメーターで列挙を指定することにより、 RichTextBoxFinds.Reverse options 既定の上から下への検索方法ではなく、ドキュメントの下部から一番上までのテキストを検索できます。By specifying the RichTextBoxFinds.Reverse enumeration in the options parameter, you can search for text from the bottom of the document to the top instead of the default top to bottom search method. このバージョンの Find メソッドを使用すると、コントロールのテキスト内で特定の開始位置を選択して、テキストの検索を絞り込むこともできます。This version of the Find method also enables you to narrow the search for text by selecting a specific starting position within the control's text. この機能を使用すると、既に検索されている可能性があるテキストや、検索する特定のテキストが存在しないことがわかっているテキストを避けることができます。This feature can enable you to avoid text that might have already been searched or where the specific text you are searching for is known not to exist. RichTextBoxFinds.Reverseパラメーターに値が指定され options ている場合、 start このバージョンのメソッドを使用すると、ドキュメントの末尾から検索が開始されるため、このパラメーターの値は、逆順検索が終了する位置を示し Find ます。When the RichTextBoxFinds.Reverse value is specified in the options parameter, the value of the start parameter indicates the position where the reverse search will end since the search will start at the bottom of the document when using this version of the Find method.

注意

Findstring パラメーターとして受け取るメソッドは、内の複数行のテキストに含まれるテキストを見つけることができません RichTextBoxThe Find methods that accept a string as a parameter cannot find text that is contained on more than one line of text within the RichTextBox. このような検索を実行すると、負の 1 (-1) の値が返されます。Performing such a search will return a value of negative one (-1).

Find(Char[], Int32, Int32)

RichTextBox コントロールのテキスト範囲内で、文字リストに含まれる文字のうち、最初に見つかる文字を検索します。Searches a range of text in a RichTextBox control for the first instance of a character from a list of characters.

public:
 int Find(cli::array <char> ^ characterSet, int start, int end);
public int Find (char[] characterSet, int start, int end);
member this.Find : char[] * int * int -> int
Public Function Find (characterSet As Char(), start As Integer, end As Integer) As Integer

パラメーター

characterSet
Char[]

検索対象の文字の配列。The array of characters to search for.

start
Int32

コントロールのテキスト内で検索を開始する位置。The location within the control's text at which to begin searching.

end
Int32

コントロールのテキスト内で検索を終了する位置。The location within the control's text at which to end searching.

戻り値

Int32

コントロール内の検索文字が見つかった位置。The location within the control where the search characters are found.

例外

characterSet が null です。characterSet is null.

start が 0 未満か、コントロール内のテキストの長さを超える値です。start is less than 0 or greater than the length of the text in the control.

注釈

このバージョンのメソッドは、 Find パラメーターで指定された文字のリストから文字の最初のインスタンスを検索 characterSet し、文字の位置を返します。This version of the Find method searches for the first instance of a character from a list of characters specified in the characterSet parameter and returns the location of the character. たとえば、' Q ' という文字を含む文字の配列を渡します。For example, you pass an array of characters containing the character 'Q'. コントロールに "the Quick Brown Fox" というテキストが含まれている場合、 Find メソッドは4の値を返します。If the control contained the text "The Quick Brown Fox", the Find 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. メソッドのパラメーターに指定された文字リストの文字が見つかった場合 characterSet 、このメソッドによって返される値は、コントロール内の文字の位置を示す0から始まるインデックスです。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.

このバージョンの Find メソッドを使用すると、パラメーターとパラメーターの値を指定することによって、コントロール内のテキスト範囲から文字セットを検索でき start end ます。This version of the Find method enables you to search for a character set from a range of text in the control by specifying a value for the start and end parameters. パラメーターの値が0の場合は、 start コントロールのドキュメントの先頭から検索を開始する必要があることを示します。A value of zero for the start parameter indicates that the search should start from the beginning of the control's document. パラメーターの値が-1 の場合は、 end 検索がコントロール内のテキストの末尾で終わる必要があることを示します。A -1 value for the end parameter indicates that the search should end at the end of the text within the control. このバージョンのメソッドを使用して Find 、アプリケーションのニーズにとって重要ではないドキュメントの領域を検索しないように、コントロール内の特定のテキスト範囲に検索を絞り込むことができます。You can use this version of the Find method to narrow your search to a specific range of text within the control to avoid searching areas of the document that are not important to the needs of your application.

Find(Char[])

RichTextBox コントロールのテキスト内で、文字リストに含まれる文字のうち、最初に見つかる文字を検索します。Searches the text of a RichTextBox control for the first instance of a character from a list of characters.

public:
 int Find(cli::array <char> ^ characterSet);
public int Find (char[] characterSet);
member this.Find : char[] -> int
Public Function Find (characterSet As Char()) As Integer

パラメーター

characterSet
Char[]

検索対象の文字の配列。The array of characters to search for.

戻り値

Int32

検索対象の文字が見つかったコントロール内の位置。検索対象の文字が見つからない場合、または char パラメーターで空の検索文字が指定された場合は -1。The location within the control where the search characters were found or -1 if the search characters are not found or an empty search character set is specified in the char parameter.

次のコード例では、 RichTextBox パラメーターでメソッドに渡された文字のの内容を検索し text ます。The following code example searches the contents of a RichTextBox for the characters that are passed to the method in the text parameter. 配列の内容が text で見つかった場合 RichTextBox 、メソッドは、見つかった値のインデックスを返します。それ以外の場合は-1 を返します。If the contents of the text array are found in the RichTextBox, the method returns the index of the value that is found; otherwise, it returns -1. この例では、このメソッドが、と Form RichTextBox いう名前のコントロールと、この richTextBox1 Button button1 例で定義されているイベントハンドラーに接続さ Click れているという名前のコントロールを含むのクラスに配置する必要があります。The example requires that this method is placed in the class of a Form that contains a RichTextBox control named richTextBox1 and a Button control, named button1, that is connected to the Click event handler defined in the example.

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      array<Char>^temp1 = {'D','e','l','t','a'};
      MessageBox::Show( FindMyText( temp1 ).ToString() );
   }

public:
   int FindMyText( array<Char>^text )
   {
      // Initialize the return value to false by default.
      int returnValue = -1;

      // Ensure that a search string has been specified and a valid start point.
      if ( text->Length > 0 )
      {
         // Obtain the location of the first character found in the control
         // that matches any of the characters in the char array.
         int indexToText = richTextBox1->Find( text );

         // Determine whether the text was found in richTextBox1.
         if ( indexToText >= 0 )
         {
            // Return the location of the character.
            returnValue = indexToText;
         }
      }

      return returnValue;
   }
private void button1_Click(object sender, System.EventArgs e)
{
    MessageBox.Show(FindMyText(new char[]{'D','e','l','t','a'}).ToString());
}

public int FindMyText(char[] text)
{
    // Initialize the return value to false by default.
    int returnValue = -1;

    // Ensure that a search string has been specified and a valid start point.
    if (text.Length > 0) 
    {
        // Obtain the location of the first character found in the control
        // that matches any of the characters in the char array.
        int indexToText = richTextBox1.Find(text);
        // Determine whether the text was found in richTextBox1.
        if(indexToText >= 0)
        {
            // Return the location of the character.
            returnValue = indexToText;
        }
    }

    return returnValue;
}
Private Sub button1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button1.Click
    MessageBox.Show(FindMyText(New Char() {"B"c, "r"c, "a"c, "v"c, "o"c}).ToString())
End Sub


Public Function FindMyText(ByVal [text]() As Char) As Integer
    ' Initialize the return value to false by default.
    Dim returnValue As Integer = -1

    ' Ensure that a search string has been specified and a valid start point.
    If [text].Length > 0 Then
        ' Obtain the location of the first character found in the control
        ' that matches any of the characters in the char array.
        Dim indexToText As Integer = richTextBox1.Find([text])
        ' Determine whether the text was found in richTextBox1.
        If indexToText >= 0 Then
            ' Return the location of the character.
            returnValue = indexToText
        End If
    End If

    Return returnValue
End Function

注釈

このバージョンのメソッドは、 Find パラメーターで指定された文字のリストから文字の最初のインスタンスを検索 characterSet し、文字の位置を返します。This version of the Find method searches for the first instance of a character from a list of characters specified in the characterSet parameter and returns the location of the character. たとえば、' Q ' という文字を含む文字の配列を渡します。For example, you pass an array of characters containing the character 'Q'. コントロールに "the Quick Brown Fox" というテキストが含まれている場合、 Find メソッドは4の値を返します。If the control contained the text "The Quick Brown Fox", the Find 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. このバージョンのメソッドでは、 Find コントロールに含まれるドキュメント全体が文字を検索する必要があります。This version of the Find method requires that the entire document contained in the control is searched for the characters. メソッドのパラメーターに指定された文字リストの文字が見つかった場合 characterSet 、このメソッドによって返される値は、コントロール内の文字の位置の0から始まるインデックスです。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.

Find(Char[], Int32)

RichTextBox コントロールのテキスト内で、検索開始位置を指定して、文字リストに含まれる文字のうち最初に見つかる文字を検索します。Searches the text of a RichTextBox control, at a specific starting point, for the first instance of a character from a list of characters.

public:
 int Find(cli::array <char> ^ characterSet, int start);
public int Find (char[] characterSet, int start);
member this.Find : char[] * int -> int
Public Function Find (characterSet As Char(), start As Integer) As Integer

パラメーター

characterSet
Char[]

検索対象の文字の配列。The array of characters to search for.

start
Int32

コントロールのテキスト内で検索を開始する位置。The location within the control's text at which to begin searching.

戻り値

Int32

コントロール内の検索文字が見つかった位置。The location within the control where the search characters are found.

次のコード例では、 RichTextBox パラメーターでメソッドに渡された文字のの内容を検索し text ます。The following code example searches the contents of a RichTextBox for the characters that are passed to the method in the text parameter. 検索は、 RichTextBox メソッドのパラメーターによって指定された内の位置から開始され start FindMyText ます。The search begins from the location within the RichTextBox specified by the start parameter of the FindMyText method. テキスト配列の内容がで見つかった場合 RichTextBox 、メソッドは、見つかった値のインデックスを返します。それ以外の場合は-1 を返します。If the contents of the text array are found in the RichTextBox, the method returns the index of the value that is found; otherwise, it returns -1. この例では、このメソッドが、と Form RichTextBox いう名前のコントロールと、この richTextBox1 Button button1 Click 例で定義されているイベントハンドラーに接続されたという名前のコントロールを含む、のクラスに配置されている必要があります。The example requires that this method is placed in the class of a Form that contains a RichTextBox control named richTextBox1 and a Button control named button1 that is connected to the Click event handler defined in the example.

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      array<Char>^temp0 = {'B','r','a','v','o'};
      MessageBox::Show( FindMyText( temp0, 5 ).ToString() );
   }

public:
   int FindMyText( array<Char>^text, int start )
   {
      // Initialize the return value to false by default.
      int returnValue = -1;

      // Ensure that a valid char array has been specified and a valid start point.
      if ( text->Length > 0 && start >= 0 )
      {
         // Obtain the location of the first character found in the control
         // that matches any of the characters in the char array.
         int indexToText = richTextBox1->Find( text, start );

         // Determine whether any of the chars are found in richTextBox1.
         if ( indexToText >= 0 )
         {
            // Return the location of the character.
            returnValue = indexToText;
         }
      }

      return returnValue;
   }
private void button1_Click(object sender, System.EventArgs e)
{
    MessageBox.Show(FindMyText(new char[]{'B','r','a','v','o'}, 5).ToString());
}

public int FindMyText(char[] text, int start)
{
    // Initialize the return value to false by default.
    int returnValue = -1;

    // Ensure that a valid char array has been specified and a valid start point.
    if (text.Length > 0 && start >= 0) 
    {
        // Obtain the location of the first character found in the control
        // that matches any of the characters in the char array.
        int indexToText = richTextBox1.Find(text, start);
        // Determine whether any of the chars are found in richTextBox1.
        if(indexToText >= 0)
        {
            // Return the location of the character.
            returnValue = indexToText;
        }
    }

    return returnValue;
}
Private Sub button1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button1.Click
    MessageBox.Show(FindMyText(New Char() {"B"c, "r"c, "a"c, "v"c, "o"c}, 5).ToString())
End Sub


Public Function FindMyText(ByVal text() As Char, ByVal start As Integer) As Integer
    ' Initialize the return value to false by default.
    Dim returnValue As Integer = -1

    ' Ensure that a valid char array has been specified and a valid start point.
    If [text].Length > 0 And start >= 0 Then
        ' Obtain the location of the first character found in the control
        ' that matches any of the characters in the char array.
        Dim indexToText As Integer = richTextBox1.Find([text], start)
        ' Determine whether any of the chars are found in richTextBox1.
        If indexToText >= 0 Then
            ' Return the location of the character.
            returnValue = indexToText
        End If
    End If

    Return returnValue
End Function

注釈

このバージョンのメソッドは、 Find パラメーターで指定された文字のリストから文字の最初のインスタンスを検索 characterSet し、文字の位置を返します。This version of the Find 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. たとえば、' Q ' という文字を含む文字の配列を渡します。For example, you pass an array of characters containing the character 'Q'. コントロールに "the Quick Brown Fox" というテキストが含まれている場合、 Find メソッドは4の値を返します。If the control contained the text "The Quick Brown Fox", the Find 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. メソッドのパラメーターに指定された文字リストの文字が見つかった場合 characterSet 、このメソッドによって返される値は、コントロール内の文字の位置の0から始まるインデックスです。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.

このバージョンの Find メソッドを使用すると、パラメーターの値を指定することによって、コントロールのテキスト内で指定された開始位置から文字セットを検索でき start ます。This version of the Find 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. 値が0の場合は、コントロールのドキュメントの先頭から検索を開始する必要があることを示します。A value of zero indicates that the search should start from the beginning of the control's document. このバージョンのメソッドを使用すると、検索対象として指定された文字が含まれて Find いない、または検索で重要ではないことがわかっているテキストを避けるために、検索を絞り込むことができます。You can use this version of the Find 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.

Find(String)

RichTextBox コントロール内のテキストで文字列を検索します。Searches the text in a RichTextBox control for a string.

public:
 int Find(System::String ^ str);
public int Find (string str);
member this.Find : string -> int
Public Function Find (str As String) As Integer

パラメーター

str
String

コントロール内で検索するテキスト。The text to locate in the control.

戻り値

Int32

検索文字列が見つかったコントロール内の位置。検索文字列が見つからない場合、または str パラメーターで空の検索文字列が指定された場合は -1。The location within the control where the search text was found or -1 if the search string is not found or an empty search string is specified in the str parameter.

次のコード例では、 RichTextBox メソッドの text パラメーターに渡された検索文字列の最初のインスタンスについて、のコンテンツ全体を検索します。The following code example searches the entire contents of a RichTextBox for the first instance of a search string passed into the text parameter of the method. 検索文字列がに見つかった場合、 RichTextBox メソッドはの値を返し、 true 検索テキストを強調表示します。それ以外の場合は、を返し false ます。If the search string is found in the RichTextBox, the method returns a value of true and highlights the search text, otherwise it returns false. この例では、このメソッドが、 Form という名前のを含むのクラスに配置されている必要があり RichTextBox richTextBox1 ます。The example requires that this method is placed in the class of a Form that contains a RichTextBox named richTextBox1.

public:
   bool FindMyText( String^ text )
   {
      // Initialize the return value to false by default.
      bool returnValue = false;
      
      // Ensure a search string has been specified.
      if ( text->Length > 0 )
      {
         // Obtain the location of the search string in richTextBox1.
         int indexToText = richTextBox1->Find( text );
         // Determine whether the text was found in richTextBox1.
         if ( indexToText >= 0 )
         {
            returnValue = true;
         }
      }

      return returnValue;
   }
public bool FindMyText(string text)
{
   // Initialize the return value to false by default.
   bool returnValue = false;

   // Ensure a search string has been specified.
   if (text.Length > 0) 
   {
      // Obtain the location of the search string in richTextBox1.
      int indexToText = richTextBox1.Find(text);
      // Determine whether the text was found in richTextBox1.
      if(indexToText >= 0)
      {
         returnValue = true;
      }
   }

   return returnValue;
}

Public Function FindMyText(text As String) As Boolean
    ' Initialize the return value to false by default.
    Dim returnValue As Boolean = False
    
    ' Ensure a search string has been specified.
    If text.Length > 0 Then
        ' Obtain the location of the search string in richTextBox1.
        Dim indexToText As Integer = richTextBox1.Find(text)
        ' Determine whether the text was found in richTextBox1.
        If indexToText >= 0 Then
            returnValue = True
        End If
    End If
    
    Return returnValue
End Function

注釈

メソッドは、 Find パラメーターで指定されたテキストを検索 str し、コントロール内の最初の文字の位置を返します。The Find method searches for the text specified in the str parameter and returns the location of the first character within the control. プロパティが負の値を返す場合、検索対象のテキスト文字列がコントロールの内容内に見つかりませんでした。If the property returns a negative value, the text string being searched for was not found within the contents of the control. このメソッドを使用すると、コントロールのユーザーに提供できる検索機能を作成できます。You can use this method to create search functionality that can be provided to the user of the control. また、このメソッドを使用して、特定の形式で置き換えるテキストを検索することもできます。You can also use this method to search for text to be replaced with a specific format. たとえば、ユーザーがコントロールに日付を入力した場合、メソッドを使用し Find て、ドキュメント内のすべての日付を検索し、適切な形式に置き換えてから、コントロールのメソッドを使用することができ SaveFile ます。For example, if the user entered dates into the control, you could use the Find method to search for all dates in the document and replace them with the appropriate format before using the SaveFile method of the control.

注意

Findstring パラメーターとして受け取るメソッドは、内の複数行のテキストに含まれるテキストを見つけることができません RichTextBoxThe Find methods that accept a string as a parameter cannot find text that is contained on more than one line of text within the RichTextBox. このような検索を実行すると、負の 1 (-1) の値が返されます。Performing such a search will return a value of negative one (-1).

Find(String, RichTextBoxFinds)

特定の検索オプションを適用して、RichTextBox コントロール内のテキストで文字列を検索します。Searches the text in a RichTextBox control for a string with specific options applied to the search.

public:
 int Find(System::String ^ str, System::Windows::Forms::RichTextBoxFinds options);
public int Find (string str, System.Windows.Forms.RichTextBoxFinds options);
member this.Find : string * System.Windows.Forms.RichTextBoxFinds -> int
Public Function Find (str As String, options As RichTextBoxFinds) As Integer

パラメーター

str
String

コントロール内で検索するテキスト。The text to locate in the control.

options
RichTextBoxFinds

RichTextBoxFinds 値のビットごとの組み合わせ。A bitwise combination of the RichTextBoxFinds values.

戻り値

Int32

コントロール内の検索文字列が見つかった位置。The location within the control where the search text was found.

次のコード例では、 RichTextBox メソッドの text パラメーターに渡された検索文字列の最初のインスタンスについて、のコンテンツ全体を検索します。The following code example searches the entire contents of a RichTextBox for the first instance of a search string passed into the text parameter of the method. 検索文字列がに見つかった場合 RichTextBox 、メソッドは値を返し、テキストを強調表示します。 true それ以外の場合はを返し false ます。If the search string is found in the RichTextBox, the method returns a value of true and highlights the text; otherwise, it returns false. この例では、指定した検索文字列の大文字と小文字を区別するために、検索のオプションも指定します。The example also specifies options in the search to match the case of the specified search string. この例では、このメソッドが、 Form という名前のを含むのクラスに配置されている必要があり RichTextBox richTextBox1 ます。The example requires that this method is placed in the class of a Form that contains a RichTextBox named richTextBox1.

public:
   bool FindMyText( String^ text )
   {
      // Initialize the return value to false by default.
      bool returnValue = false;
      
      // Ensure a search string has been specified.
      if ( text->Length > 0 )
      {
         // Obtain the location of the search string in richTextBox1.
         int indexToText = richTextBox1->Find( text, RichTextBoxFinds::MatchCase );
         // Determine if the text was found in richTextBox1.
         if ( indexToText >= 0 )
         {
            returnValue = true;
         }
      }

      return returnValue;
   }
public bool FindMyText(string text)
{
   // Initialize the return value to false by default.
   bool returnValue = false;

   // Ensure a search string has been specified.
   if (text.Length > 0) 
   {
      // Obtain the location of the search string in richTextBox1.
      int indexToText = richTextBox1.Find(text, RichTextBoxFinds.MatchCase);
      // Determine if the text was found in richTextBox1.
      if(indexToText >= 0)
      {
         returnValue = true;
      }
   }

   return returnValue;
}

Public Function FindMyText(text As String) As Boolean
    ' Initialize the return value to false by default.
    Dim returnValue As Boolean = False
    
    ' Ensure a search string has been specified.
    If text.Length > 0 Then
        ' Obtain the location of the search string in richTextBox1.
        Dim indexToText As Integer = richTextBox1.Find(text, RichTextBoxFinds.MatchCase)
        ' Determine if the text was found in richTextBox1.
        If indexToText >= 0 Then
            returnValue = True
        End If
    End If
    
    Return returnValue
End Function

注釈

メソッドは、 Find パラメーターで指定されたテキストを検索 str し、コントロール内の最初の文字の位置を返します。The Find method searches for the text specified in the str parameter and returns the location of the first character within the control. プロパティが負の値を返す場合、検索対象のテキスト文字列がコントロールの内容内に見つかりませんでした。If the property returns a negative value, the text string being searched for was not found within the contents of the control. このメソッドを使用すると、コントロールのユーザーに提供できる検索機能を作成できます。You can use this method to create search functionality that can be provided to the user of the control. また、このメソッドを使用して、特定の形式で置き換えるテキストを検索することもできます。You can also use this method to search for text to be replaced with a specific format. たとえば、ユーザーがコントロールに日付を入力した場合は、メソッドを使用し Find て、ドキュメント内のすべての日付を検索し、適切な形式に置き換えることができます。その後、 SaveFile コントロールのメソッドを使用します。For example, if the user entered dates into the control, you can use the Find method to search for all dates in the document and replace them with the appropriate format before using the SaveFile method of the control.

このバージョンのメソッドでは Find 、検索を拡大または縮小できるようにするオプションを指定できます。With this version of the Find method, you can specify options that enable you to expand or narrow your search. 検索語の大文字と小文字の区別を一致させるオプションや、部分的な単語ではなく単語全体を検索するオプションを指定できます。You can specify options that enable you to match the casing of the search word or to search for entire words instead of partial words. パラメーターで列挙を指定することにより、 RichTextBoxFinds.Reverse options 既定の上から下への検索方法ではなく、ドキュメントの下部から一番上までのテキストを検索できます。By specifying the RichTextBoxFinds.Reverse enumeration in the options parameter, you can search for text from the bottom of the document to the top instead of the default top to bottom search method.

注意

Findstring パラメーターとして受け取るメソッドは、内の複数行のテキストに含まれるテキストを見つけることができません RichTextBoxThe Find methods that accept a string as a parameter cannot find text that is contained on more than one line of text within the RichTextBox. このような検索を実行すると、負の 1 (-1) の値が返されます。Performing such a search will return a value of negative one (-1).

適用対象