Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

RichTextBox.Find (Método) (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.

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
Tipo: System.String
Texto que se debe buscar en el control.
start
Tipo: System.Int32
Lugar en el texto del control en el que comenzará la búsqueda.
options
Tipo: System.Windows.Forms.RichTextBoxFinds
Combinación bit a bit de los valores de RichTextBoxFinds.

Valor devuelto

Tipo: System.Int32
Lugar del control en el que se encontró el texto buscado.

El método Find busca el texto especificado en el parámetro str y devuelve la ubicación del primer carácter de la cadena de búsqueda en el control. Si la propiedad devuelve un valor negativo, significa que la cadena de texto buscada no se encontró en el contenido del control. Se puede utilizar este método para crear funciones de búsqueda destinadas al usuario del control. También se puede utilizar este método para buscar aquel texto que se desee reemplazar por un formato específico. Por ejemplo, si el usuario escribió fechas en el control, se puede utilizar el método Find para buscar todas las fechas del documento y aplicarles el formato correcto antes de utilizar el método SaveFile del control.

Con esta versión del método Find, se pueden especificar opciones que permitan ampliar o restringir el ámbito de la búsqueda, como que coincidan mayúsculas y minúsculas o que se busquen únicamente palabras completas en lugar una parte de las palabras. Al especificar la enumeración RichTextBoxFinds.Reverse en el parámetro options, se puede buscar texto de la parte inferior del documento hacia la parte superior, en lugar de utilizar el método de búsqueda predeterminado de arriba a abajo. Esta versión del método Find también 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 excluir texto que ya fue objeto de esta búsqueda o lugares donde se sabe que no se encuentra el texto específico de la búsqueda. Cuando se especifica el valor RichTextBoxFinds.Reverse en el parámetro options, el valor del parámetro start 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 del método Find.

NotaNota

Los métodos Find que aceptan un string como parámetro no pueden encontrar texto contenido en más de una línea de texto en RichTextBox. La realización de una búsqueda así devolverá un valor de uno negativo (-1).

En el ejemplo de código siguiente se busca en todo el contenido de RichTextBox la primera instancia de una cadena de búsqueda pasada en el parámetro de texto del método. La ubicación inicial de la búsqueda se especifica mediante el parámetro Start del método. Si la cadena de búsqueda se encuentra en el objeto RichTextBox, el método devuelve la ubicación de índice del primer carácter del texto encontrado y resalta dicho texto; en caso contrario, devuelve el valor -1. En el ejemplo también se definen opciones de búsqueda para que coincidan los caracteres en mayúscula y minúscula de la cadena especificada. En el ejemplo se requiere que este método esté incluido en la clase de un Form que contenga un control RichTextBox denominado richTextBox1. Puede utilizar este ejemplo para realizar una operación de tipo "Buscar siguiente". Una vez encontrada una instancia del texto de búsqueda, puede encontrar otras instancias cambiando el valor del parámetro start para buscar en una ubicación situada después 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

Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft