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)

 

Data di pubblicazione: ottobre 2016

Cerca nel testo in un RichTextBox controllo per una stringa.

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

public int Find(
	string str
)

Parametri

str
Type: System.String

Testo da individuare nel controllo.

Valore restituito

Type: System.Int32

La posizione all'interno del controllo in cui è stato trovato il testo di ricerca o -1 se la stringa di ricerca non viene trovata o se viene specificata una stringa di ricerca vuota il str parametro.

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.

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 di ricerca, in caso contrario restituirà false. 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);
      // Determine whether the text was found in richTextBox1.
      if(indexToText >= 0)
      {
         returnValue = true;
      }
   }

   return returnValue;
}

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