Comparteix a través de

RichTextBox.Find Método

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Busca texto en el contenido de RichTextBox.

Sobrecargas

Find(Char[])

Busca en el texto de un control RichTextBox la primera instancia de uno de los caracteres en una lista de caracteres.
Find(String)

Busca una cadena en el texto de un control RichTextBox.
Find(Char[], Int32)

Busca en el texto de un control RichTextBox la primera instancia de uno de los caracteres de una lista de caracteres a partir de un punto específico.
Find(String, RichTextBoxFinds)

Busca una cadena en el texto de un control RichTextBox aplicando opciones específicas a la búsqueda.
Find(Char[], Int32, Int32)

Busca en un intervalo de texto de un control RichTextBox la primera instancia de uno de los caracteres de una lista de caracteres.
Find(String, Int32, RichTextBoxFinds)

Busca una cadena en el texto de un control RichTextBox en una ubicación específica del control y aplicando opciones específicas a la búsqueda.
Find(String, Int32, Int32, RichTextBoxFinds)

Busca una cadena en el texto de un control RichTextBox en un intervalo de texto del control y aplicando opciones específicas a la búsqueda.

Find(Char[])

Busca en el texto de un control RichTextBox la primera instancia de uno de los caracteres en una lista de caracteres.

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

characterSet
Char[]

Matriz de caracteres que se va a buscar.

Devoluciones

Int32

Ubicación en el control donde se encontraron los caracteres de búsqueda o -1 si no se encontraron los caracteres de búsqueda o se ha especificado un juego de caracteres de búsqueda en el parámetro char.

Ejemplos

En el ejemplo de código siguiente se busca el contenido de para RichTextBox los caracteres que se pasan al método en el text parámetro . Si el contenido de la text matriz se encuentra en RichTextBox, el método devuelve el índice del valor que se encuentra; de lo contrario, devuelve -1. El ejemplo requiere que este método se coloque en la clase de que Form contiene un RichTextBox control denominado richTextBox1 y un Button control, denominado button1, que está conectado al Click controlador de eventos definido en el ejemplo.

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

Comentarios

Esta versión del Find método busca la primera instancia de un carácter de una lista de caracteres especificado en el characterSet parámetro y devuelve la ubicación del carácter. Por ejemplo, se pasa una matriz de caracteres que contiene el carácter "Q". Si el control contenía el texto "The Quick Brown Fox", el Find método devolvería el valor de cuatro. Un carácter en mayúsculas y un carácter en minúsculas se consideran valores diferentes en la búsqueda.

Si la propiedad devuelve un valor negativo, los caracteres que se buscan no se encontraron dentro del contenido del control. Puede usar este método para buscar un grupo de caracteres dentro del control . Esta versión del Find método requiere que se busquen los caracteres en todo el documento contenido en el control. Si se encuentra un carácter de la lista de caracteres proporcionada en el parámetro del characterSet método, el valor devuelto por este método es un índice de base cero de la posición del carácter en el control. El método considera un carácter un espacio al determinar la ubicación de un carácter.

Se aplica a

Find(String)

Busca una cadena en el texto de un control 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

Parámetros

str
String

Texto que se debe buscar en el control.

Devoluciones

Int32

Ubicación en el control donde se encontró el texto de búsqueda o -1 si no se encontró la cadena de búsqueda o se ha especificado una cadena de búsqueda vacía en el parámetro str.

Ejemplos

En el ejemplo de código siguiente se busca todo el contenido de para RichTextBox la primera instancia de una cadena de búsqueda que se pasa al parámetro text del método . Si la cadena de búsqueda se encuentra en RichTextBox, el método devuelve un valor de y resalta el texto de true búsqueda; de lo contrario, devuelve false. El ejemplo requiere que este método se coloque en la clase de un Form objeto que contiene un RichTextBox objeto denominado 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

Comentarios

El Find método busca el texto especificado en el str parámetro y devuelve la ubicación del primer carácter dentro del control. Si la propiedad devuelve un valor negativo, no se encontró la cadena de texto que se busca en el contenido del control. Puede usar este método para crear la funcionalidad de búsqueda que se puede proporcionar al usuario del control. También puede usar este método para buscar texto que se reemplace por un formato específico. Por ejemplo, si el usuario escribió fechas en el control, podría usar el Find método para buscar todas las fechas del documento y reemplazarlas por el formato adecuado antes de usar el SaveFile método del control.

Nota:

Los Find métodos que aceptan como string parámetro no pueden encontrar texto contenido en más de una línea de texto dentro RichTextBoxde . Al realizar esta búsqueda, se devolverá un valor de negativo (-1).

Se aplica a

Find(Char[], Int32)

Busca en el texto de un control RichTextBox la primera instancia de uno de los caracteres de una lista de caracteres a partir de un punto específico.

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

characterSet
Char[]

Matriz de caracteres que se va a buscar.

start
Int32

Lugar en el texto del control en el que comenzará la búsqueda.

Devoluciones

Int32

Lugar del control en el que se encuentran los caracteres buscados.

Ejemplos

En el ejemplo de código siguiente se busca el contenido de para RichTextBox los caracteres que se pasan al método en el text parámetro . La búsqueda comienza desde la ubicación dentro RichTextBox del especificado por el start parámetro del FindMyText método . Si el contenido de la matriz de texto se encuentra en RichTextBox, el método devuelve el índice del valor que se encuentra; de lo contrario, devuelve -1. El ejemplo requiere que este método se coloque en la clase de que Form contiene un RichTextBox control denominado richTextBox1 y un Button control denominado button1 que está conectado al Click controlador de eventos definido en el ejemplo.

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

Comentarios

Esta versión del Find método busca la primera instancia de un carácter de una lista de caracteres especificado en el characterSet parámetro y devuelve la ubicación del carácter. Por ejemplo, se pasa una matriz de caracteres que contiene el carácter "Q". Si el control contenía el texto "The Quick Brown Fox", el Find método devolvería el valor de cuatro. Un carácter en mayúsculas y un carácter en minúsculas se consideran valores diferentes en la búsqueda.

Si la propiedad devuelve un valor negativo, los caracteres que se buscan no se encontraron dentro del contenido del control. Puede usar este método para buscar un grupo de caracteres dentro del control . Si se encuentra un carácter de la lista de caracteres proporcionada en el parámetro del characterSet método, el valor devuelto por este método es un índice de base cero de la posición del carácter en el control. El método considera un carácter un espacio al determinar la ubicación de un carácter.

Esta versión del Find método permite buscar un juego de caracteres desde una posición inicial especificada dentro del texto del control especificando un valor para el start parámetro . Un valor de cero indica que la búsqueda debe comenzar desde el principio del documento del control. Puede usar esta versión del método para restringir la Find búsqueda para evitar el texto que ya sabe que no contiene los caracteres especificados que está buscando o no son importantes en la búsqueda.

Se aplica a

Find(String, RichTextBoxFinds)

Busca una cadena en el texto de un control RichTextBox aplicando opciones específicas a la búsqueda.

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

str
String

Texto que se debe buscar en el control.

options
RichTextBoxFinds

Combinación bit a bit de los valores de RichTextBoxFinds.

Devoluciones

Int32

Lugar del control en el que se encontró el texto buscado.

Ejemplos

En el ejemplo de código siguiente se busca todo el contenido de para RichTextBox la primera instancia de una cadena de búsqueda que se pasa al parámetro text del método . Si la cadena de búsqueda se encuentra en RichTextBox, el método devuelve un valor de true y resalta el texto; de lo contrario, devuelve false. En el ejemplo también se especifican las opciones de la búsqueda para que coincidan con el caso de la cadena de búsqueda especificada. El ejemplo requiere que este método se coloque en la clase de un Form objeto que contiene un RichTextBox objeto denominado 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

Comentarios

El Find método busca el texto especificado en el str parámetro y devuelve la ubicación del primer carácter dentro del control. Si la propiedad devuelve un valor negativo, no se encontró la cadena de texto que se busca en el contenido del control. Puede usar este método para crear la funcionalidad de búsqueda que se puede proporcionar al usuario del control. También puede usar este método para buscar texto que se reemplace por un formato específico. Por ejemplo, si el usuario escribió fechas en el control, puede usar el Find método para buscar todas las fechas del documento y reemplazarlas por el formato adecuado antes de usar el SaveFile método del control.

Con esta versión del Find método, puede especificar opciones que le permitan expandir o restringir la búsqueda. Puede especificar opciones que le permitan coincidir con el uso de mayúsculas y minúsculas de la palabra de búsqueda o buscar palabras completas en lugar de palabras parciales. Al especificar la RichTextBoxFinds.Reverse enumeración en el options parámetro , puede buscar texto desde la parte inferior del documento hasta la parte superior en lugar del método de búsqueda predeterminado de arriba a abajo.

Nota:

Los Find métodos que aceptan como string parámetro no pueden encontrar texto contenido en más de una línea de texto dentro RichTextBoxde . Al realizar esta búsqueda, se devolverá un valor de negativo (-1).

Se aplica a

Find(Char[], Int32, Int32)

Busca en un intervalo de texto de un control RichTextBox la primera instancia de uno de los caracteres de una lista de caracteres.

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

characterSet
Char[]

Matriz de caracteres que se va a buscar.

start
Int32

Lugar en el texto del control en el que comenzará la búsqueda.

end
Int32

Lugar en el texto del control en el que finalizará la búsqueda.

Devoluciones

Int32

Lugar del control en el que se encuentran los caracteres buscados.

Excepciones

ArgumentNullException

characterSet es null.

ArgumentException

start es menor que cero o mayor que la longitud del texto del control.

Comentarios

Esta versión del Find método busca la primera instancia de un carácter de una lista de caracteres especificado en el characterSet parámetro y devuelve la ubicación del carácter. Por ejemplo, se pasa una matriz de caracteres que contiene el carácter "Q". Si el control contenía el texto "The Quick Brown Fox", el Find método devolvería el valor de cuatro. Un carácter en mayúsculas y un carácter en minúsculas se consideran valores diferentes en la búsqueda.

Si la propiedad devuelve un valor negativo, los caracteres que se buscan no se encontraron dentro del contenido del control. Puede usar este método para buscar un grupo de caracteres dentro del control . Si se encuentra un carácter de la lista de caracteres proporcionada en el parámetro del characterSet método, el valor devuelto por este método es un índice de base cero de la posición del carácter en el control. El método considera un carácter un espacio al determinar la ubicación de un carácter.

Esta versión del Find método permite buscar un juego de caracteres desde un intervalo de texto en el control especificando un valor para los start parámetros y end . Un valor de cero para el start parámetro indica que la búsqueda debe comenzar desde el principio del documento del control. Un valor -1 para el end parámetro indica que la búsqueda debe terminar al final del texto dentro del control. Puede usar esta versión del método para restringir la Find búsqueda a un intervalo de texto específico dentro del control para evitar buscar áreas del documento que no son importantes para las necesidades de la aplicación.

Se aplica a

Find(String, Int32, RichTextBoxFinds)

Busca una cadena en el texto de un control RichTextBox en una ubicación específica del control y aplicando opciones específicas a la búsqueda.

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

str
String

Texto que se debe buscar en el control.

start
Int32

Lugar en el texto del control en el que comenzará la búsqueda.

options
RichTextBoxFinds

Combinación bit a bit de los valores de RichTextBoxFinds.

Devoluciones

Int32

Lugar del control en el que se encontró el texto buscado.

Ejemplos

En el ejemplo de código siguiente se busca todo el contenido de una RichTextBox para la primera instancia de una cadena de búsqueda pasada al parámetro de texto del método . La ubicación inicial de búsqueda se especifica mediante el parámetro start del método . Si la cadena de búsqueda se encuentra en RichTextBox, el método devuelve la ubicación del índice del primer carácter del texto encontrado y resalta el texto encontrado; de lo contrario, devuelve un valor de -1. En el ejemplo también se especifican las opciones de la búsqueda para que coincidan con el caso de la cadena de búsqueda especificada. El ejemplo requiere que este método se coloque en la clase de un Form objeto que contiene un RichTextBox elemento denominado richTextBox1. Puede usar este ejemplo para realizar un tipo de operación "Buscar siguiente". Una vez encontrada una instancia del texto de búsqueda, puede encontrar otras instancias del texto cambiando el valor del start parámetro para buscar en una ubicación más allá de la posición de la coincidencia actual.

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

Comentarios

El Find método busca el texto especificado en el str parámetro y devuelve la ubicación del primer carácter de la cadena de búsqueda dentro del control . Si la propiedad devuelve un valor negativo, no se encontró la cadena de texto que se busca en el contenido del control. Puede usar este método para crear la funcionalidad de búsqueda que se puede proporcionar al usuario del control. También puede usar este método para buscar texto que se va a reemplazar por un formato específico. Por ejemplo, si el usuario escribió fechas en el control, podría usar el Find método para buscar todas las fechas del documento y reemplazarlas por el formato adecuado antes de usar el SaveFile método del control .

Con esta versión del Find método, puede especificar opciones que le permitan expandir o restringir la búsqueda. Puede especificar opciones que le permitan coincidir con el uso de mayúsculas y minúsculas de la palabra de búsqueda o buscar palabras completas en lugar de palabras parciales. Al especificar la RichTextBoxFinds.Reverse enumeración en el options parámetro , puede buscar texto desde la parte inferior del documento a la parte superior en lugar del método de búsqueda predeterminado de arriba a abajo. Esta versión del Find método también permite restringir la búsqueda de texto seleccionando una posición inicial específica dentro del texto del control. Esta característica puede permitirle evitar texto que ya se haya buscado o en el que se sepa que no existe el texto específico que está buscando. Cuando se especifica el RichTextBoxFinds.Reverse valor en el options parámetro , el valor del start parámetro indica la posición donde finalizará la búsqueda inversa, ya que la búsqueda comenzará en la parte inferior del documento al usar esta versión del Find método .

Nota:

Los Find métodos que aceptan como string parámetro no pueden encontrar texto contenido en más de una línea de texto dentro RichTextBoxde . Al realizar esta búsqueda, se devolverá un valor negativo (-1).

Se aplica a

Find(String, Int32, Int32, RichTextBoxFinds)

Busca una cadena en el texto de un control RichTextBox en un intervalo de texto del control y aplicando opciones específicas a la búsqueda.

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

str
String

Texto que se debe buscar en el control.

start
Int32

Lugar en el texto del control en el que comenzará la búsqueda.

end
Int32

Lugar en el texto del control en el que finalizará la búsqueda. Este valor debe ser -1 o mayor o igual que el valor del parámetro start.

options
RichTextBoxFinds

Combinación bit a bit de los valores de RichTextBoxFinds.

Devoluciones

Int32

Lugar del control en el que se encontró el texto buscado.

Excepciones

ArgumentNullException

El parámetro str era null.

ArgumentException

El parámetro start era menor que cero.

o bien

El valor del parámetro end era menor que el valor del parámetro start.

Ejemplos

En el ejemplo de código siguiente se busca una sección de texto en para RichTextBox la primera instancia de una cadena de búsqueda pasada al searchText parámetro del método . El intervalo que se va a buscar texto dentro del control se especifica mediante los searchStart parámetros y searchEnd del método . Si la cadena de búsqueda se encuentra en RichTextBox, el método devuelve la ubicación del índice del primer carácter del texto encontrado y resalta el texto encontrado; de lo contrario, devuelve un valor de -1. En el ejemplo también se usa el options parámetro del Find método para especificar que el texto encontrado debe coincidir con el caso de la cadena de búsqueda. El ejemplo requiere que este método se coloque en la clase de que Form contiene un RichTextBox control denominado richTextBox1. Una vez encontrada la primera instancia de la cadena de búsqueda, puede usar este ejemplo para buscar otras instancias en el 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

Comentarios

El Find método busca el texto especificado en el str parámetro y devuelve la ubicación del primer carácter de la cadena de búsqueda dentro del control . Si la propiedad devuelve un valor negativo, no se encontró la cadena de texto que se busca en el contenido del control. Puede usar este método para crear la funcionalidad de búsqueda que se puede proporcionar al usuario del control. También puede usar este método para buscar texto que se va a reemplazar por un formato específico. Por ejemplo, si el usuario escribió fechas en el control, puede usar el Find método para buscar todas las fechas del documento y reemplazarlas por el formato adecuado antes de usar el SaveFile método del control .

Con esta versión del Find método, puede especificar opciones que le permitan expandir o restringir la búsqueda. Puede especificar opciones que le permitan coincidir con el uso de mayúsculas y minúsculas de la palabra de búsqueda o buscar palabras completas en lugar de palabras parciales. Al especificar la RichTextBoxFinds.Reverse enumeración en el options parámetro , puede buscar texto desde la parte inferior del documento a la parte superior en lugar del método de búsqueda predeterminado de arriba a abajo. Esta versión del Find método también le permite restringir la búsqueda de texto seleccionando una posición de inicio y finalización específica dentro del texto del control. Esta característica puede permitirle limitar el intervalo de búsqueda a una sección específica del texto del control. Si se asigna un valor negativo (-1) al end parámetro , el método buscará hasta el final del texto en para RichTextBox las búsquedas normales. En el caso de las búsquedas inversas, un valor de negativo (-1) asignado al end parámetro indica que se buscará texto desde el final del texto (inferior) hasta la posición definida por start el parámetro . Cuando se proporcionan los start parámetros y end el mismo valor, se busca en búsquedas normales todo el control. Para una búsqueda inversa, se busca todo el control, pero la búsqueda comienza en la parte inferior del documento y busca en la parte superior del documento.

Nota:

Los Find métodos que aceptan como string parámetro no pueden encontrar texto contenido en más de una línea de texto dentro RichTextBoxde . Al realizar esta búsqueda, se devolverá un valor negativo (-1).

Se aplica a