RichTextBoxFinds Enumeração
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Especifica como uma pesquisa de texto é realizada em um controle RichTextBox.
Essa enumeração dá suporte a uma combinação bit a bit dos valores de membro.
public enum class RichTextBoxFinds
[System.Flags]
public enum RichTextBoxFinds
[<System.Flags>]
type RichTextBoxFinds =
Public Enum RichTextBoxFinds
- Herança
- Atributos
Campos
MatchCase | 4 | Localize somente as instâncias do texto da pesquisa idênticas nas maiúsculas e minúsculas. |
NoHighlight | 8 | O texto de pesquisa, se encontrado, não deve ser realçado. |
None | 0 | Localize todas as instâncias do texto da pesquisa, sejam elas palavras inteiras ou não. |
Reverse | 16 | A pesquisa inicia no final do documento de controle e pesquisa em direção ao início do documento. |
WholeWord | 2 | Localize somente as instâncias do texto da pesquisa que são palavras inteiras. |
Exemplos
O exemplo a seguir pesquisa todo o conteúdo de um RichTextBox para a primeira instância de uma cadeia de caracteres de pesquisa passada para o parâmetro de texto do método. O local inicial da pesquisa é especificado pelo parâmetro de início do método. Se a cadeia de caracteres de pesquisa for encontrada no RichTextBoxmétodo, o método retornará o local do índice do primeiro caractere do texto encontrado e realça o texto encontrado; caso contrário, ele retornará um valor de -1. O exemplo também especifica opções na pesquisa para corresponder ao caso da cadeia de caracteres de pesquisa especificada. O exemplo pressupõe que esse método seja colocado na classe de um Form que contém um RichTextBox nome richTextBox1
. Você pode usar este exemplo ao executar uma operação de tipo "Localizar Próximo" depois que a primeira instância do texto de pesquisa for encontrada para localizar outras instâncias do 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
Comentários
Um aplicativo localiza o RichTextBox texto no controle chamando o Find método do RichTextBox controle. Essa enumeração permite que você especifique como a pesquisa é executada quando o Find método é chamado. Você pode combinar um ou mais valores dessa enumeração para especificar mais de uma opção de pesquisa ao chamar o Find método.