RichTextBox.Find Метод

Определение

Выполняет поиск текста в содержимом объекта RichTextBox.

Перегрузки

Имя Описание
Find(Char[])

Выполняет поиск текста RichTextBox элемента управления для первого экземпляра символа из списка символов.

Find(String)

Выполняет поиск текста в элементе RichTextBox управления для строки.

Find(Char[], Int32)

Выполняет поиск текста RichTextBox элемента управления в определенной начальной точке для первого экземпляра символа из списка символов.

Find(String, RichTextBoxFinds)

Выполняет поиск текста в элементе RichTextBox управления для строки с определенными параметрами, примененными к поиску.

Find(Char[], Int32, Int32)

Выполняет поиск диапазона текста в RichTextBox элементе управления для первого экземпляра символа из списка символов.

Find(String, Int32, RichTextBoxFinds)

Выполняет поиск текста в RichTextBox элементе управления для строки в определенном расположении элемента управления и с определенными параметрами, примененными к поиску.

Find(String, Int32, Int32, RichTextBoxFinds)

Выполняет поиск текста в элементе управления для строки в RichTextBox диапазоне текста в элементе управления и с определенными параметрами, примененными к поиску.

Find(Char[])

Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs

Выполняет поиск текста RichTextBox элемента управления для первого экземпляра символа из списка символов.

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[]

Массив символов для поиска.

Возвращаемое значение

Расположение в элементе управления, где найдены символы поиска или -1, если символы поиска не найдены, или в параметре указан char пустой набор символов поиска.

Примеры

В следующем примере кода выполняется поиск содержимого RichTextBox символов, передаваемых методу в параметре text . Если содержимое массива text найдено, RichTextBoxметод возвращает индекс найденного значения; в противном случае возвращает значение -1. В примере требуется, чтобы этот метод помещается в класс, Form содержащий RichTextBox элемент управления с именем richTextBox1 и Button элементом управления, который button1подключен к Click обработчику событий, определенному в примере.

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 , и возвращает расположение символа. Например, вы передаете массив символов, содержащий символ Q. Если элемент управления содержит текст "Quick Brown Fox", Find метод вернет значение четырех. Верхний регистр и нижний регистр считаются различными значениями в поиске.

Если свойство возвращает отрицательное значение, поиск символов не найден в содержимом элемента управления. Этот метод можно использовать для поиска группы символов в элементе управления. Для этой версии Find метода требуется, чтобы весь документ, содержащийся в элементе управления, искать символы. Если символ из списка символов, указанный в параметре метода characterSet , найден, значение, возвращаемое этим методом, является отсчитываемым от нуля индексом позиции символа в элементе управления. Пробел считается символом метода при определении расположения символа.

Применяется к

Find(String)

Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs

Выполняет поиск текста в элементе RichTextBox управления для строки.

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

Текст, который нужно найти в элементе управления.

Возвращаемое значение

Расположение в элементе управления, где найден текст поиска или -1, если строка поиска не найдена, или в параметре указана str пустая строка поиска.

Примеры

В следующем примере кода выполняется поиск всего содержимого RichTextBox первого экземпляра строки поиска, переданного в текстовый параметр метода. Если строка поиска найдена в RichTextBoxобъекте, метод возвращает значение true и выделяет текст поиска, в противном случае возвращается false. В примере требуется, чтобы этот метод помещается в класс, Form содержащий именованный RichTextBoxrichTextBox1.

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 , и возвращает расположение первого символа в элементе управления. Если свойство возвращает отрицательное значение, поиск текстовой строки не найден в содержимом элемента управления. Этот метод можно использовать для создания функциональных возможностей поиска, которые можно предоставить пользователю элемента управления. Этот метод также можно использовать для поиска текста, заменяемого определенным форматом. Например, если пользователь ввел даты в элемент управления, можно использовать Find метод для поиска всех дат в документе и заменить их соответствующим форматом перед использованием SaveFile метода элемента управления.

Note

МетодыFind, принимаюющие string в качестве параметра, не могут найти текст, содержащийся в нескольких строках текста в пределах.RichTextBox При выполнении такого поиска возвращается отрицательное значение (-1).

Применяется к

Find(Char[], Int32)

Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs

Выполняет поиск текста RichTextBox элемента управления в определенной начальной точке для первого экземпляра символа из списка символов.

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[]

Массив символов для поиска.

start
Int32

Расположение в тексте элемента управления, с которого начинается поиск.

Возвращаемое значение

Расположение в элементе управления, где находятся символы поиска.

Примеры

В следующем примере кода выполняется поиск содержимого RichTextBox символов, передаваемых методу в параметре text . Поиск начинается с расположения, RichTextBox указанного startFindMyText параметром метода. Если содержимое текстового массива найдено в RichTextBoxобъекте, метод возвращает индекс найденного значения; в противном случае возвращает значение -1. В примере требуется, чтобы этот метод помещается в класс, Form содержащий RichTextBox элемент управления с именем richTextBox1 и Button элемент button1 управления, подключенный к Click обработчику событий, определенному в примере.

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 , и возвращает расположение символа. Например, вы передаете массив символов, содержащий символ Q. Если элемент управления содержит текст "Quick Brown Fox", Find метод вернет значение четырех. Верхний регистр и нижний регистр считаются различными значениями в поиске.

Если свойство возвращает отрицательное значение, поиск символов не найден в содержимом элемента управления. Этот метод можно использовать для поиска группы символов в элементе управления. Если символ из списка символов, указанный в параметре метода characterSet , найден, значение, возвращаемое этим методом, является отсчитываемым от нуля индексом позиции символа в элементе управления. Пробел считается символом метода при определении расположения символа.

Эта версия Find метода позволяет искать символьный набор из указанной начальной позиции в тексте элемента управления, указав значение параметра start . Значение нуля указывает, что поиск должен начинаться с начала документа элемента управления. Эту версию Find метода можно использовать для сузки поиска, чтобы избежать того, что текст, который вы уже знаете, не содержит указанных символов, которые вы ищете или не важны в поиске.

Применяется к

Find(String, RichTextBoxFinds)

Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs

Выполняет поиск текста в элементе RichTextBox управления для строки с определенными параметрами, примененными к поиску.

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

Текст, который нужно найти в элементе управления.

options
RichTextBoxFinds

Побитовое сочетание значений RichTextBoxFinds .

Возвращаемое значение

Расположение в элементе управления, где найден текст поиска.

Примеры

В следующем примере кода выполняется поиск всего содержимого RichTextBox первого экземпляра строки поиска, переданного в текстовый параметр метода. Если в строке поиска найдена RichTextBoxстрока поиска, метод возвращает значение true и выделяет текст; в противном случае возвращается false. В примере также указываются параметры в поиске, соответствующие регистру указанной строки поиска. В примере требуется, чтобы этот метод помещается в класс, Form содержащий именованный RichTextBoxrichTextBox1.

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 , и возвращает расположение первого символа в элементе управления. Если свойство возвращает отрицательное значение, поиск текстовой строки не найден в содержимом элемента управления. Этот метод можно использовать для создания функциональных возможностей поиска, которые можно предоставить пользователю элемента управления. Этот метод также можно использовать для поиска текста, заменяемого определенным форматом. Например, если пользователь ввел даты в элемент управления, можно использовать Find метод для поиска всех дат в документе и заменить их соответствующим форматом перед использованием SaveFile метода элемента управления.

С помощью этой версии Find метода можно указать параметры, позволяющие расширить или сузить поиск. Можно указать параметры, позволяющие сопоставить регистр слова поиска или искать все слова вместо частичных слов. Указав RichTextBoxFinds.Reverse перечисление в options параметре, можно искать текст из нижней части документа в верхнюю часть вместо метода поиска по умолчанию в нижней части.

Note

МетодыFind, принимаюющие string в качестве параметра, не могут найти текст, содержащийся в нескольких строках текста в пределах.RichTextBox При выполнении такого поиска возвращается отрицательное значение (-1).

Применяется к

Find(Char[], Int32, Int32)

Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs

Выполняет поиск диапазона текста в RichTextBox элементе управления для первого экземпляра символа из списка символов.

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[]

Массив символов для поиска.

start
Int32

Расположение в тексте элемента управления, с которого начинается поиск.

end
Int32

Расположение в тексте элемента управления, в котором выполняется поиск.

Возвращаемое значение

Расположение в элементе управления, где находятся символы поиска.

Исключения

Параметр characterSet имеет значение null.

start значение меньше 0 или больше длины текста в элементе управления.

Комментарии

Эта версия Find метода выполняет поиск первого экземпляра символа из списка символов, указанных в параметре characterSet , и возвращает расположение символа. Например, вы передаете массив символов, содержащий символ Q. Если элемент управления содержит текст "Quick Brown Fox", Find метод вернет значение четырех. Верхний регистр и нижний регистр считаются различными значениями в поиске.

Если свойство возвращает отрицательное значение, поиск символов не найден в содержимом элемента управления. Этот метод можно использовать для поиска группы символов в элементе управления. Если символ из списка символов, указанный в параметре метода characterSet , найден, значение, возвращаемое этим методом, является отсчитываемым от нуля индекс позиции символа в элементе управления. Пробел считается символом метода при определении расположения символа.

Эта версия Find метода позволяет искать символьный набор из диапазона текста в элементе управления, указав значение для start параметров и end параметров. Значение нуля для start параметра указывает, что поиск должен начинаться с начала документа элемента управления. Значение -1 для end параметра указывает, что поиск должен заканчиваться в конце текста в элементе управления. Эту версию Find метода можно использовать для сужения поиска до определенного диапазона текста в элементе управления, чтобы избежать поиска областей документа, которые не важны для потребностей приложения.

Применяется к

Find(String, Int32, RichTextBoxFinds)

Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs

Выполняет поиск текста в RichTextBox элементе управления для строки в определенном расположении элемента управления и с определенными параметрами, примененными к поиску.

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

Текст, который нужно найти в элементе управления.

start
Int32

Расположение в тексте элемента управления, с которого начинается поиск.

options
RichTextBoxFinds

Побитовое сочетание значений RichTextBoxFinds .

Возвращаемое значение

Расположение в элементе управления, где найден текст поиска.

Примеры

В следующем примере кода выполняется поиск всего содержимого RichTextBox первого экземпляра строки поиска, переданного в текстовый параметр метода. Начальная расположение поиска указывается начальным параметром метода. Если строка поиска найдена в RichTextBoxметоде, метод возвращает расположение индекса первого символа найденного текста и выделяет найденный текст; в противном случае возвращает значение -1. В примере также указываются параметры в поиске, соответствующие регистру указанной строки поиска. В примере требуется, чтобы этот метод помещается в класс, Form содержащий именованный RichTextBoxrichTextBox1. Этот пример можно использовать для выполнения операции "Найти далее". После обнаружения экземпляра текста поиска можно найти другие экземпляры текста, изменив значение start параметра для поиска в расположении за пределами текущего совпадения.

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 , и возвращает расположение первого символа строки поиска в элементе управления. Если свойство возвращает отрицательное значение, поиск текстовой строки не найден в содержимом элемента управления. Этот метод можно использовать для создания функциональных возможностей поиска, которые можно предоставить пользователю элемента управления. Этот метод также можно использовать для поиска текста, заменяемого определенным форматом. Например, если пользователь ввел даты в элемент управления, можно использовать Find метод для поиска всех дат в документе и заменить их соответствующим форматом перед использованием SaveFile метода элемента управления.

С помощью этой версии Find метода можно указать параметры, позволяющие расширить или сузить поиск. Можно указать параметры, позволяющие сопоставить регистр слова поиска или искать все слова вместо частичных слов. Указав RichTextBoxFinds.Reverse перечисление в options параметре, можно искать текст из нижней части документа в верхнюю часть вместо метода поиска по умолчанию в нижней части. Эта версия Find метода также позволяет сузить поиск текста, выбрав определенную начальную позицию в тексте элемента управления. Эта функция позволяет избежать поиска текста, который, возможно, уже был выполнен или где определенный текст, который вы ищете, не существует. RichTextBoxFinds.Reverse Если значение указано в options параметре, значение start параметра указывает положение, в котором будет заканчиваться обратный поиск, так как поиск начнется в нижней части документа при использовании этой версии Find метода.

Note

МетодыFind, принимаюющие string в качестве параметра, не могут найти текст, содержащийся в нескольких строках текста в пределах.RichTextBox При выполнении такого поиска возвращается отрицательное значение (-1).

Применяется к

Find(String, Int32, Int32, RichTextBoxFinds)

Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs
Исходный код:
RichTextBox.cs

Выполняет поиск текста в элементе управления для строки в RichTextBox диапазоне текста в элементе управления и с определенными параметрами, примененными к поиску.

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

Текст, который нужно найти в элементе управления.

start
Int32

Расположение в тексте элемента управления, с которого начинается поиск.

end
Int32

Расположение в тексте элемента управления, в котором выполняется поиск. Это значение должно быть равно отрицательному (-1) или больше или равно параметру start .

options
RichTextBoxFinds

Побитовое сочетание значений RichTextBoxFinds .

Возвращаемое значение

Расположение в элементе управления, где найден текст поиска.

Исключения

Параметр str был null.

Параметр start был меньше нуля.

–или–

Параметр end был меньше start параметра.

Примеры

В следующем примере кода выполняется поиск раздела текста в RichTextBox первом экземпляре строки поиска, переданной в searchText параметр метода. Диапазон для поиска текста в элементе управления определяется searchStart и searchEnd параметрами метода. Если строка поиска найдена в RichTextBoxметоде, метод возвращает расположение индекса первого символа найденного текста и выделяет найденный текст; в противном случае возвращает значение -1. В примере также используется options параметр Find метода, чтобы указать, что найденный текст должен соответствовать регистру строки поиска. В примере требуется, чтобы этот метод помещается в класс, Form содержащий RichTextBox элемент управления с именем richTextBox1. После того как первый экземпляр строки поиска найден, этот пример можно использовать для поиска других экземпляров в тексте.

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 , и возвращает расположение первого символа строки поиска в элементе управления. Если свойство возвращает отрицательное значение, поиск текстовой строки не найден в содержимом элемента управления. Этот метод можно использовать для создания функциональных возможностей поиска, которые можно предоставить пользователю элемента управления. Этот метод также можно использовать для поиска текста, заменяемого определенным форматом. Например, если пользователь ввел даты в элемент управления, можно использовать Find метод для поиска всех дат в документе и заменить их соответствующим форматом перед использованием SaveFile метода элемента управления.

С помощью этой версии Find метода можно указать параметры, позволяющие расширить или сузить поиск. Можно указать параметры, позволяющие сопоставить регистр слова поиска или искать все слова вместо частичных слов. Указав RichTextBoxFinds.Reverse перечисление в options параметре, можно искать текст из нижней части документа в верхнюю часть вместо метода поиска по умолчанию в нижней части. Эта версия Find метода также позволяет сузить поиск текста, выбрав определенную начальную и конечную позицию в тексте элемента управления. Эта функция позволяет ограничить диапазон поиска определенным разделом текста элемента управления. Если параметру назначено end значение отрицательного значения (-1), метод будет выполнять поиск до конца текста в обычном поиске RichTextBox . Для обратного поиска значение отрицательного (-1) , назначенное end параметру, указывает, что текст будет искать в конце текста (внизу) до позиции, определенной параметром start . start Если указаны и параметры, то же значение, что и end весь элемент управления, выполняется поиск по обычному поиску. Для обратного поиска весь элемент управления выполняется поиск, но поиск начинается в нижней части документа и выполняет поиск в верхней части документа.

Note

МетодыFind, принимаюющие string в качестве параметра, не могут найти текст, содержащийся в нескольких строках текста в пределах.RichTextBox При выполнении такого поиска возвращается отрицательное значение (-1).

Применяется к