RichTextBoxFinds Enumerazione
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Specifica come viene eseguita una ricerca di testo in un controllo RichTextBox.
Questa enumerazione supporta una combinazione bit per bit dei rispettivi valori dei membri.
public enum class RichTextBoxFinds
[System.Flags]
public enum RichTextBoxFinds
[<System.Flags>]
type RichTextBoxFinds =
Public Enum RichTextBoxFinds
- Ereditarietà
- Attributi
Campi
MatchCase | 4 | Consente di individuare solo istanze del testo di ricerca con l'esatta combinazione di maiuscole e minuscole. |
NoHighlight | 8 | Il testo di ricerca, se trovato, non deve essere evidenziato. |
None | 0 | Consente di individuare tutte le istanze del testo di ricerca, indipendentemente dal fatto che le istanze trovate siano parole intere o meno. |
Reverse | 16 | La ricerca inizia alla fine del documento del controllo e continua fino all'inizio del documento. |
WholeWord | 2 | Consente di individuare solo istanze del testo di ricerca rappresentate da parole intere. |
Esempio
Nell'esempio seguente viene eseguita la ricerca dell'intero contenuto di un RichTextBox oggetto per la prima istanza di una stringa di ricerca passata nel parametro di testo del metodo . Il percorso iniziale della ricerca viene specificato dal parametro start del metodo . Se la stringa di ricerca viene trovata in RichTextBox, il metodo restituisce la posizione di indice del primo carattere del testo trovato ed evidenzia il testo trovato; in caso contrario, restituisce il valore -1. Nell'esempio vengono inoltre specificate le opzioni nella ricerca in modo che corrispondano al caso della stringa di ricerca specificata. Nell'esempio si presuppone che questo metodo venga inserito nella classe di un Form oggetto contenente un RichTextBox oggetto denominato richTextBox1
. È possibile usare questo esempio quando si esegue un'operazione di tipo "Trova successivo" dopo che è stata trovata la prima istanza del testo di ricerca per trovare altre istanze del testo.
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
Commenti
Un'applicazione individua il testo nel RichTextBox controllo chiamando il Find metodo del RichTextBox controllo . Questa enumerazione consente di specificare la modalità di esecuzione della ricerca quando viene chiamato il Find metodo . È possibile combinare uno o più valori di questa enumerazione per specificare più opzioni di ricerca quando si chiama il Find metodo .