RichTextBoxFinds Enumeración
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Especifica cómo se realiza una búsqueda de texto en un control RichTextBox.
Esta enumeración admite una combinación bit a bit de sus valores de miembro.
public enum class RichTextBoxFinds
[System.Flags]
public enum RichTextBoxFinds
[<System.Flags>]
type RichTextBoxFinds =
Public Enum RichTextBoxFinds
- Herencia
- Atributos
Campos
MatchCase | 4 | Localiza sólo instancias del texto de búsqueda que coinciden en el uso de mayúsculas y minúsculas. |
NoHighlight | 8 | El texto de búsqueda, si se encuentra, no debe resaltarse. |
None | 0 | Localiza todas las instancias del texto de búsqueda, tanto si las instancias encontradas en la búsqueda son palabras enteras como si no lo son. |
Reverse | 16 | La búsqueda comienza al final del documento del control y busca hasta el principio del documento. |
WholeWord | 2 | Localiza sólo instancias del texto de búsqueda que sean palabras completas. |
Ejemplos
En el ejemplo siguiente se busca todo el contenido de para RichTextBox la primera instancia de una cadena de búsqueda pasada al parámetro text 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. En el ejemplo se supone que este método se coloca en la clase de que Form contiene un RichTextBox objeto denominado richTextBox1
. Puede usar este ejemplo al realizar una operación de tipo "Buscar siguiente" una vez que se haya encontrado la primera instancia de texto de búsqueda para buscar otras instancias del texto.
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
Una aplicación busca texto en el RichTextBox control llamando al Find método del RichTextBox control . Esta enumeración permite especificar cómo se realiza la búsqueda cuando se llama al Find método . Puede combinar uno o varios valores de esta enumeración para especificar más de una opción de búsqueda al llamar al Find método .