RichTextBox.Find Método

Definición

Busca texto dentro del contenido de RichTextBox.

Sobrecargas

Nombre Description
Find(Char[])

Busca en el texto de un RichTextBox control la primera instancia de un carácter de una lista de caracteres.

Find(String)

Busca en una cadena el texto de un RichTextBox control.

Find(Char[], Int32)

Busca en el texto de un RichTextBox control, en un punto de partida específico, la primera instancia de un carácter de una lista de caracteres.

Find(String, RichTextBoxFinds)

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

Find(Char[], Int32, Int32)

Busca un intervalo de texto en un RichTextBox control para la primera instancia de un carácter de una lista de caracteres.

Find(String, Int32, RichTextBoxFinds)

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

Find(String, Int32, Int32, RichTextBoxFinds)

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

Find(Char[])

Busca en el texto de un RichTextBox control la primera instancia de un carácter de 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

Ubicación dentro del control donde se encontraron los caracteres de búsqueda o -1 si no se encuentran los caracteres de búsqueda o se especifica un juego de caracteres de búsqueda vacío en el char parámetro .

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 mayúscula y un carácter en minúsculas se consideran valores diferentes en la búsqueda.

Si la propiedad devuelve un valor negativo, no se encontraron los caracteres que se buscan en el 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 proporcionado 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 espacio un carácter al determinar la ubicación de un carácter.

Se aplica a

Find(String)

Busca en una cadena el texto de un RichTextBox control.

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 va a buscar en el control.

Devoluciones

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

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 que Form 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 .

Note

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 de RichTextBox. Si realiza esta búsqueda, se devolverá un valor negativo (-1).

Se aplica a

Find(Char[], Int32)

Busca en el texto de un RichTextBox control, en un punto de partida específico, la primera instancia de un carácter de una lista de caracteres.

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

Ubicación dentro del texto del control en el que se va a empezar a buscar.

Devoluciones

Ubicación dentro del control donde se encuentran los caracteres de búsqueda.

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 del RichTextBox 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 mayúscula y un carácter en minúsculas se consideran valores diferentes en la búsqueda.

Si la propiedad devuelve un valor negativo, no se encontraron los caracteres que se buscan en el 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 proporcionado 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 espacio un carácter 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 no contiene los caracteres especificados que está buscando o no son importantes en la búsqueda.

Se aplica a

Find(String, RichTextBoxFinds)

Busca en el texto de un RichTextBox control una cadena con opciones específicas aplicadas 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 va a buscar en el control.

options
RichTextBoxFinds

Combinación bit a bit de los RichTextBoxFinds valores.

Devoluciones

Ubicación dentro del control donde se encontró el texto de búsqueda.

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 que Form 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 hacer coincidir las 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 superior a inferior predeterminado.

Note

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 de RichTextBox. Si realiza esta búsqueda, se devolverá un valor negativo (-1).

Se aplica a

Find(Char[], Int32, Int32)

Busca un intervalo de texto en un RichTextBox control para la primera instancia de un carácter 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

Ubicación dentro del texto del control en el que se va a empezar a buscar.

end
Int32

Ubicación dentro del texto del control en el que se va a finalizar la búsqueda.

Devoluciones

Ubicación dentro del control donde se encuentran los caracteres de búsqueda.

Excepciones

characterSet es null.

start es menor que 0 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 mayúscula y un carácter en minúsculas se consideran valores diferentes en la búsqueda.

Si la propiedad devuelve un valor negativo, no se encontraron los caracteres que se buscan en el 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 proporcionado 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 espacio un carácter 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 de -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 Find método para restringir la búsqueda a un intervalo específico de texto 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 en el texto de un RichTextBox control una cadena en una ubicación específica dentro del control y con opciones específicas aplicadas 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 va a buscar en el control.

start
Int32

Ubicación dentro del texto del control en el que se va a empezar a buscar.

options
RichTextBoxFinds

Combinación bit a bit de los RichTextBoxFinds valores.

Devoluciones

Ubicación dentro del control donde se encontró el texto de búsqueda.

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 . El parámetro start del método especifica la ubicación inicial de la búsqueda. 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 que Form contiene un RichTextBox objeto denominado richTextBox1. Puede usar este ejemplo para realizar un tipo de operación "Buscar siguiente". Una vez que se encuentra 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 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 .

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 hacer coincidir las 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 superior a inferior predeterminado. 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 el texto que puede 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 se iniciará en la parte inferior del documento al usar esta versión del Find método .

Note

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 de RichTextBox. Si realiza esta búsqueda, se devolverá un valor negativo (-1).

Se aplica a

Find(String, Int32, Int32, RichTextBoxFinds)

Busca en el texto de un RichTextBox control una cadena dentro de un intervalo de texto dentro del control y con opciones específicas aplicadas 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 va a buscar en el control.

start
Int32

Ubicación dentro del texto del control en el que se va a empezar a buscar.

end
Int32

Ubicación dentro del texto del control en el que se va a finalizar la búsqueda. Este valor debe ser igual a uno negativo (-1) o mayor o igual que el start parámetro .

options
RichTextBoxFinds

Combinación bit a bit de los RichTextBoxFinds valores.

Devoluciones

Ubicación dentro del control donde se encontró el texto de búsqueda.

Excepciones

El str parámetro era null.

El start parámetro era menor que cero.

O bien

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

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 que se pasa 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 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 hacer coincidir las 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 superior a inferior predeterminado. 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 de negativo (-1) al end parámetro , el método buscará hasta el final del texto en para RichTextBox las búsquedas normales. Para las búsquedas inversas, un valor de negativo uno (-1) asignado al end parámetro indica que el texto se buscará desde el final del texto (inferior) hasta la posición definida por start el parámetro . Cuando los start parámetros y end se proporcionan 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.

Note

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 de RichTextBox. Si realiza esta búsqueda, se devolverá un valor negativo (-1).

Se aplica a