Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo RichTextBox.Find (String, RichTextBoxFinds)

 

Data di pubblicazione: ottobre 2016

Cerca nel testo in un RichTextBox controllo per una stringa con opzioni specifiche applicate alla ricerca.

Spazio dei nomi:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public int Find(
	string str,
	RichTextBoxFinds options
)

Parametri

str
Type: System.String

Testo da individuare nel controllo.

options
Type: System.Windows.Forms.RichTextBoxFinds

Combinazione bit per bit dei valori di RichTextBoxFinds.

Valore restituito

Type: System.Int32

Posizione all'interno del controllo in cui è stato trovato il testo di ricerca.

Il Find metodo cerca il testo specificato nella str parametro e restituisce la posizione del primo carattere all'interno del controllo. Se la proprietà restituisce un valore negativo, la stringa di testo da cercare non trovata all'interno del contenuto del controllo. È possibile utilizzare questo metodo per creare la funzionalità di ricerca che possono essere fornite all'utente del controllo. È inoltre possibile utilizzare questo metodo per cercare il testo da sostituire con un formato specifico. Ad esempio, se l'utente ha immesso date nel controllo, è possibile utilizzare il Find per cercare tutte le date nel documento e sostituirli con il formato appropriato prima di utilizzare il SaveFile metodo del controllo.

Con questa versione di Find (metodo), è possibile specificare opzioni che consentono di espandere o restringere la ricerca. È possibile specificare le opzioni che consentono la corrispondenza di maiuscole e minuscole della parola di ricerca o per cercare parole intere anziché le parole parziali. Specificando il RichTextBoxFinds.Reverse enumerazione di options parametro, è possibile cercare il testo nella parte inferiore del documento all'inizio anziché i primi predefinito per il metodo di ricerca nella parte inferiore.

System_CAPS_noteNota

Il Find metodi che accettano un string come un parametro non può trovare il testo contenuto in più di una riga di testo all'interno di RichTextBox. L'esecuzione di tale ricerca restituirà un valore negativo (-1).

Esempio di codice seguente cerca l'intero contenuto di un RichTextBox per la prima istanza di una stringa di ricerca passato nel parametro del testo del metodo. Se viene trovata la stringa di ricerca nel RichTextBox, il metodo restituisce un valore di true ed evidenzia il testo; in caso contrario, restituisce false. Nell'esempio specifica inoltre le opzioni nella ricerca maiuscole / minuscole della stringa di ricerca specificato. Nell'esempio si presuppone che questo metodo viene collocato nella classe di un Form che contiene un RichTextBox denominato richTextBox1.

public bool FindMyText(string text)
{
   // Initialize the return value to false by default.
   bool returnValue = false;

   // Ensure a search string has been specified.
   if (text.Length > 0) 
   {
      // Obtain the location of the search string in richTextBox1.
      int indexToText = richTextBox1.Find(text, RichTextBoxFinds.MatchCase);
      // Determine if the text was found in richTextBox1.
      if(indexToText >= 0)
      {
         returnValue = true;
      }
   }

   return returnValue;
}

.NET Framework
Disponibile da 1.1
Torna all'inizio
Mostra: