Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método RichTextBox.Find (String, Int32, RichTextBoxFinds)

 

Publicado: octubre de 2016

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

Espacio de nombres:   System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)

public int Find(
	string str,
	int start,
	RichTextBoxFinds options
)

Parámetros

str
Type: System.String

Texto que se va a buscar en el control.

start
Type: System.Int32

La ubicación en el texto del control en el que se va a comenzar la búsqueda.

options
Type: System.Windows.Forms.RichTextBoxFinds

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

Valor devuelto

Type: System.Int32

La ubicación del control donde se encontró el texto de búsqueda.

El Find método busca el texto especificado en el str parámetro y devuelve la ubicación del primer carácter de la búsqueda de la cadena 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 utilizar este método para crear la funcionalidad de búsqueda que se puede proporcionar al usuario del control. También puede utilizar este método para buscar texto que se reemplaza con un formato específico. Por ejemplo, si el usuario escribió fechas en el control, puede utilizar el Find método para buscar todas las fechas del documento y reemplazarlas con el formato adecuado antes de usar el SaveFile método del control.

Con esta versión de la Find (método), puede especificar opciones que permiten ampliar o limitar la búsqueda. Puede especificar opciones que le permiten hacer coincidir las mayúsculas y minúsculas de la palabra de búsqueda o para buscar palabras completas en lugar de palabras parciales. Especificando el RichTextBoxFinds.Reverse (enumeración) en el options parámetro, puede buscar texto en la parte inferior del documento en la parte superior en lugar de forma predeterminada al método de búsqueda de la parte inferior. Esta versión de la Find método también le permite limitar la búsqueda de texto mediante la selección de una posición inicial específica en el texto del control. Esta característica permite evitar el texto que podría ya se han buscado o donde el texto específico que está buscando se sabe que no existe. Cuando el RichTextBoxFinds.Reverse valor se especifica en el options parámetro, el valor de la start parámetro indica la posición en la que finalizará la búsqueda inversa ya que la búsqueda empezará en la parte inferior del documento al utilizar esta versión de la Find (método).

System_CAPS_noteNota

El Find métodos que aceptan un string como un parámetro no puede encontrar el texto contenido en más de una línea de texto dentro de la RichTextBox. Realización de una búsqueda devolverá un valor negativo uno (-1).

En el ejemplo de código siguiente se busca en todo el contenido de una RichTextBox para la primera instancia de una cadena de búsqueda pasada en el parámetro de texto del método. La ubicación inicial de búsqueda especificada por el parámetro de inicio del método. Si la cadena de búsqueda se encuentra en la RichTextBox, el método devuelve la ubicación de índice del primer carácter del texto encontrado y resalta el texto; de lo contrario, devuelve un valor de -1. El ejemplo también especifica opciones de búsqueda para que se corresponda con el formato de la cadena de búsqueda especificado. El ejemplo requiere que este método está incluido en la clase de un Form que contiene un RichTextBox denominado richTextBox1. Puede utilizar este ejemplo para realizar un tipo de operación "Buscar siguiente". Una vez que se ha encontrado una instancia del texto de búsqueda, puede encontrar otras instancias del texto cambiando el valor de la 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;
}

.NET Framework
Disponible desde 1.1
Volver al principio
Mostrar: