RichTextBox.Find Método

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

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

Parâmetros

Devoluções

A localização dentro do controlo onde os caracteres de pesquisa foram encontrados ou -1 se os caracteres de pesquisa não forem encontrados ou se for especificado um conjunto vazio de caracteres de pesquisa no char parâmetro.

Exemplos

O seguinte exemplo de código pesquisa no conteúdo de a RichTextBox os caracteres que são passados para o método no text parâmetro. Se o conteúdo do text array for encontrado em , RichTextBoxo método devolve o índice do valor encontrado; caso contrário, retorna -1. O exemplo exige que este método seja colocado na classe de a Form que contém um RichTextBox controlo nomeado richTextBox1 e um Button controlo chamado button1, que está ligado ao Click handler de eventos definido no exemplo.

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

Observações

Esta versão do Find método procura a primeira instância de um carácter a partir de uma lista de caracteres especificados no characterSet parâmetro e retorna a localização do carácter. Por exemplo, passa um array de caracteres que contém o carácter 'Q'. Se o controlo contivesse o texto "The Quick Brown Fox", o Find método devolveria o valor de quatro. Um carácter maiúsculo e um caractere minúsculo são considerados valores diferentes na pesquisa.

Se a propriedade devolver um valor negativo, os caracteres procurados não foram encontrados no conteúdo do controlo. Podes usar este método para procurar um grupo de caracteres dentro do controlo. Esta versão do Find método exige que todo o documento contido no controlo seja pesquisado pelos caracteres. Se for encontrado um carácter da lista de caracteres fornecida no parâmetro do characterSet método, o valor devolvido por este método é um índice zero da posição do carácter no controlo. Um espaço é considerado um carácter pelo método ao determinar a localização de um carácter.

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

public:
 int Find(System::String ^ str);

public int Find(string str);

member this.Find : string -> int

Public Function Find (str As String) As Integer

Parâmetros

Devoluções

A localização dentro do controlo onde o texto de pesquisa foi encontrado ou -1 se a cadeia de pesquisa não for encontrada ou se for especificada uma cadeia de pesquisa vazia no str parâmetro.

Exemplos

O exemplo de código seguinte pesquisa todo o conteúdo de um RichTextBox para a primeira instância de uma cadeia de pesquisa passada no parâmetro de texto do método. Se a cadeia de pesquisa for encontrada em , RichTextBoxo método devolve um valor de true e destaca o texto da pesquisa, caso contrário devolve false. O exemplo exige que este método seja colocado na classe de a Form que contém um RichTextBox nome 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

Observações

O Find método procura o texto especificado no str parâmetro e retorna a localização do primeiro carácter dentro do controlo. Se a propriedade devolver um valor negativo, a cadeia de texto procurada não foi encontrada no conteúdo do controlo. Pode usar este método para criar funcionalidades de pesquisa que podem ser fornecidas ao utilizador do controlo. Também pode usar este método para procurar texto a substituir por um formato específico. Por exemplo, se o utilizador introduziu datas no controlo, pode usar o Find método para procurar todas as datas no documento e substituí-las pelo formato apropriado antes de usar o SaveFile método do controlo.

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

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

Parâmetros

Devoluções

A localização dentro do controlo onde se encontram os caracteres de pesquisa.

Exemplos

O seguinte exemplo de código pesquisa no conteúdo de a RichTextBox os caracteres que são passados para o método no text parâmetro. A pesquisa começa na localização dentro do RichTextBox especificado pelo start parâmetro do FindMyText método. Se o conteúdo do array de texto for encontrado no RichTextBox, o método devolve o índice do valor encontrado; caso contrário, devolve -1. O exemplo exige que este método seja colocado na classe de a Form que contém um RichTextBox controlo nomeado richTextBox1 e um Button controlo nomeado button1 que está ligado ao Click gestor de eventos definido no exemplo.

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

Observações

Esta versão do Find método procura a primeira instância de um carácter a partir de uma lista de caracteres especificada no characterSet parâmetro e devolve a localização do carácter. Por exemplo, passa um array de caracteres que contém o carácter 'Q'. Se o controlo contivesse o texto "The Quick Brown Fox", o Find método devolveria o valor de quatro. Um carácter maiúsculo e um caractere minúsculo são considerados valores diferentes na pesquisa.

Se a propriedade devolver um valor negativo, os caracteres procurados não foram encontrados no conteúdo do controlo. Podes usar este método para procurar um grupo de caracteres dentro do controlo. Se for encontrado um carácter da lista de caracteres fornecida no parâmetro do characterSet método, o valor devolvido por este método é um índice zero da posição do carácter no controlo. Um espaço é considerado um carácter pelo método ao determinar a localização de um carácter.

Esta versão do Find método permite-lhe procurar um conjunto de caracteres a partir de uma posição inicial especificada dentro do texto do controlo, especificando um valor para o start parâmetro. Um valor zero indica que a pesquisa deve começar pelo início do documento do controlo. Pode usar esta versão do Find método para restringir a sua pesquisa, evitando texto que já sabe que não contém os caracteres especificados que procura ou que não são importantes na sua pesquisa.

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

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

Parâmetros

Devoluções

A localização dentro do controlo onde o texto da pesquisa foi encontrado.

Exemplos

O exemplo de código seguinte pesquisa todo o conteúdo de um RichTextBox para a primeira instância de uma cadeia de pesquisa passada no parâmetro de texto do método. Se a cadeia de pesquisa for encontrada em , RichTextBoxo método devolve um valor de true e destaca o texto; caso contrário, devolve false. O exemplo também especifica opções na pesquisa para corresponder ao caso da cadeia de pesquisa especificada. O exemplo exige que este método seja colocado na classe de a Form que contém um RichTextBox nome 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

Observações

O Find método procura o texto especificado no str parâmetro e retorna a localização do primeiro carácter dentro do controlo. Se a propriedade devolver um valor negativo, a cadeia de texto procurada não foi encontrada no conteúdo do controlo. Pode usar este método para criar funcionalidades de pesquisa que podem ser fornecidas ao utilizador do controlo. Também pode usar este método para procurar texto a substituir por um formato específico. Por exemplo, se o utilizador introduziu datas no controlo, pode usar o Find método para procurar todas as datas no documento e substituí-las pelo formato apropriado antes de usar o SaveFile método do controlo.

Com esta versão do Find método, pode especificar opções que lhe permitam expandir ou restringir a sua pesquisa. Pode especificar opções que lhe permitam corresponder à maiúscula da palavra de pesquisa ou procurar palavras inteiras em vez de parciais. Ao especificar a RichTextBoxFinds.Reverse enumeração no options parâmetro, pode procurar texto do fundo do documento até ao topo em vez do método padrão de pesquisa de cima para baixo.

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

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

Parâmetros

Devoluções

A localização dentro do controlo onde se encontram os caracteres de pesquisa.

Exceções

Observações

Esta versão do Find método procura a primeira instância de um carácter a partir de uma lista de caracteres especificados no characterSet parâmetro e retorna a localização do carácter. Por exemplo, passa um array de caracteres que contém o carácter 'Q'. Se o controlo contivesse o texto "The Quick Brown Fox", o Find método devolveria o valor de quatro. Um carácter maiúsculo e um caractere minúsculo são considerados valores diferentes na pesquisa.

Se a propriedade devolver um valor negativo, os caracteres procurados não foram encontrados no conteúdo do controlo. Podes usar este método para procurar um grupo de caracteres dentro do controlo. Se for encontrado um carácter da lista de caracteres fornecida no parâmetro do characterSet método, o valor devolvido por este método é um índice baseado em zero da posição do carácter no controlo. Um espaço é considerado um carácter pelo método ao determinar a localização de um carácter.

Esta versão do Find método permite-lhe pesquisar um conjunto de caracteres a partir de um intervalo de texto no controlo, especificando um valor para os start parâmetros e.end Um valor zero para o start parâmetro indica que a pesquisa deve começar pelo início do documento do controlo. Um valor -1 para o end parâmetro indica que a pesquisa deve terminar no final do texto dentro do controlo. Pode usar esta versão do Find método para restringir a sua pesquisa a um intervalo específico de texto dentro do controlo, evitando assim procurar áreas do documento que não são importantes para as necessidades da sua aplicação.

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

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

Parâmetros

Devoluções

A localização dentro do controlo onde o texto da pesquisa foi encontrado.

Exemplos

O exemplo de código seguinte pesquisa todo o conteúdo de um RichTextBox para a primeira instância de uma cadeia de pesquisa passada no parâmetro de texto do método. A localização inicial da pesquisa é especificada pelo parâmetro inicial do método. Se a cadeia de pesquisa for encontrada em , RichTextBoxo método devolve a localização do índice do primeiro carácter do texto encontrado e destaca o texto encontrado; caso contrário, devolve um valor de -1. O exemplo também especifica opções na pesquisa para corresponder ao caso da cadeia de pesquisa especificada. O exemplo exige que este método seja colocado na classe de a Form que contém um RichTextBox nome richTextBox1. Pode usar este exemplo para realizar uma operação do tipo "Encontrar Próximo". Depois de encontrar uma instância do texto de pesquisa, pode encontrar outras instâncias do texto alterando o valor do start parâmetro para procurar numa localização além da posição da correspondência atual.

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

Observações

O Find método procura o texto especificado no str parâmetro e retorna a localização do primeiro carácter da cadeia de pesquisa dentro do controlo. Se a propriedade devolver um valor negativo, a cadeia de texto procurada não foi encontrada no conteúdo do controlo. Pode usar este método para criar funcionalidades de pesquisa que podem ser fornecidas ao utilizador do controlo. Também pode usar este método para procurar texto a substituir por um formato específico. Por exemplo, se o utilizador introduziu datas no controlo, pode usar o Find método para procurar todas as datas no documento e substituí-las pelo formato apropriado antes de usar o SaveFile método do controlo.

Com esta versão do Find método, pode especificar opções que lhe permitam expandir ou restringir a sua pesquisa. Pode especificar opções que lhe permitam corresponder à maiúscula da palavra de pesquisa ou procurar palavras inteiras em vez de parciais. Ao especificar a RichTextBoxFinds.Reverse enumeração no options parâmetro, pode procurar texto do fundo do documento até ao topo em vez do método padrão de pesquisa de cima para baixo. Esta versão do Find método também permite restringir a pesquisa por texto selecionando uma posição inicial específica dentro do texto do controlo. Esta funcionalidade pode permitir-lhe evitar textos que possam já ter sido pesquisados ou onde o texto específico que procura não é conhecido por existir. Quando o RichTextBoxFinds.Reverse valor é especificado no options parâmetro, o valor do start parâmetro indica a posição onde a pesquisa reversa terminará, uma vez que a pesquisa começará no final do documento ao utilizar esta versão do Find método.

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

Origem:

RichTextBox.cs

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

Parâmetros

Devoluções

A localização dentro do controlo onde o texto da pesquisa foi encontrado.

Exceções

Exemplos

O exemplo de código seguinte pesquisa uma secção de texto em a RichTextBox para a primeira instância de uma cadeia de pesquisa passada no searchText parâmetro do método. O intervalo a procurar texto dentro do controlo é especificado pelos searchStart parâmetros e searchEnd do método. Se a cadeia de pesquisa for encontrada em , RichTextBoxo método devolve a localização do índice do primeiro carácter do texto encontrado e destaca o texto encontrado; caso contrário, devolve um valor de -1. O exemplo também usa o options parâmetro do Find método para especificar que o texto encontrado deve corresponder ao caso da cadeia de pesquisa. O exemplo exige que este método seja colocado na classe de a Form que contém um RichTextBox controlo chamado richTextBox1. Depois de encontrar a primeira instância da cadeia de pesquisa, pode usar este exemplo para encontrar outras instâncias no texto.

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

Observações

O Find método procura o texto especificado no str parâmetro e retorna a localização do primeiro carácter da cadeia de pesquisa dentro do controlo. Se a propriedade devolver um valor negativo, a cadeia de texto procurada não foi encontrada no conteúdo do controlo. Pode usar este método para criar funcionalidades de pesquisa que podem ser fornecidas ao utilizador do controlo. Também pode usar este método para procurar texto a substituir por um formato específico. Por exemplo, se o utilizador introduziu datas no controlo, pode usar o Find método para procurar todas as datas no documento e substituí-las pelo formato apropriado antes de usar o SaveFile método do controlo.

Com esta versão do Find método, pode especificar opções que lhe permitam expandir ou restringir a sua pesquisa. Pode especificar opções que lhe permitam corresponder à maiúscula da palavra de pesquisa ou procurar palavras inteiras em vez de parciais. Ao especificar a RichTextBoxFinds.Reverse enumeração no options parâmetro, pode procurar texto do fundo do documento até ao topo em vez do método padrão de pesquisa de cima para baixo. Esta versão do Find método também permite restringir a pesquisa por texto selecionando uma posição específica de início e fim dentro do texto do controlo. Esta funcionalidade permite limitar o intervalo de pesquisa a uma secção específica do texto do controlo. Se for atribuído um valor de menos um (-1) ao end parâmetro, o método irá procurar até ao final do texto para RichTextBox as pesquisas normais. Para pesquisas reversas, um valor de menos um (-1) atribuído ao end parâmetro indica que o texto será pesquisado desde o fim do texto (inferior) até à posição definida pelo start parâmetro. Quando os start parâmetros e end são fornecidos com o mesmo valor, todo o controlo é pesquisado para pesquisas normais. Numa pesquisa reversa, todo o controlo é pesquisado, mas a pesquisa começa no fundo do documento e avança até ao topo do documento.