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 (Char[], Int32)

 

Data di pubblicazione: ottobre 2016

Cerca nel testo di un RichTextBox controllo, a partire da un punto specifico, la prima istanza di un carattere da un elenco di caratteri.

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

public int Find(
	char[] characterSet,
	int start
)

Parametri

characterSet
Type: System.Char[]

Matrice di caratteri da cercare.

start
Type: System.Int32

La posizione all'interno del testo del controllo in corrispondenza del quale iniziare la ricerca.

Valore restituito

Type: System.Int32

Posizione all'interno del controllo cui sono stati trovati caratteri per la ricerca.

Questa versione di Find metodo cerca la prima istanza di un carattere da un elenco di caratteri specificati nel characterSet parametro e restituisce la posizione del carattere. Ad esempio, si passa una matrice di caratteri contenente il carattere 'Q'. Se il controllo è contenuto il testo "The Quick Brown Fox", il Find metodo restituirà il valore di quattro. Un carattere maiuscolo e un carattere minuscolo sono considerati valori diversi nella ricerca.

Se la proprietà restituisce un valore negativo, i caratteri da cercare non trovati all'interno del contenuto del controllo. È possibile utilizzare questo metodo per cercare un gruppo di caratteri all'interno del controllo. Se un carattere dall'elenco di caratteri di cui il metodo characterSet parametro è stato trovato, il valore restituito da questo metodo è un indice in base zero della posizione del carattere nel controllo. Uno spazio viene considerato un carattere dal metodo per determinare la posizione di un carattere.

Questa versione di Find metodo consente di eseguire la ricerca di un gruppo di caratteri da una posizione iniziale specificata all'interno del testo del controllo, specificando un valore per il start parametro. Un valore pari a zero indica che deve avviare la ricerca dall'inizio del documento del controllo. È possibile utilizzare questa versione di Find metodo per restringere la ricerca per evitare il testo che si conosce già contiene i caratteri specificati si sta cercando o non sono rilevanti per la ricerca.

Esempio di codice seguente esegue la ricerca il contenuto di un RichTextBox per i caratteri che vengono passati al metodo di text parametro. La ricerca inizia dalla posizione all'interno di RichTextBox specificato dal start parametro del FindMyText metodo. Se il contenuto della matrice di testo, vedere il RichTextBox, il metodo restituisce l'indice del valore a cui è stato trovato; in caso contrario, restituisce -1. Nell'esempio si presuppone che questo metodo viene collocato nella classe di un Form che contiene un RichTextBox controllo denominato richTextBox1 e Button controllo denominato button1 collegata al Click gestore dell'evento definito nell'esempio.

private void button1_Click(object sender, System.EventArgs e)
{
	MessageBox.Show(FindMyText(new char[]{'B','r','a','v','o'}, 5).ToString());
}

public int FindMyText(char[] text, int start)
{
	// Initialize the return value to false by default.
	int returnValue = -1;

	// Ensure that a valid char array has been specified and a valid start point.
	if (text.Length > 0 && start >= 0) 
	{
		// Obtain the location of the first character found in the control
		// that matches any of the characters in the char array.
		int indexToText = richTextBox1.Find(text, start);
		// Determine whether any of the chars are found in richTextBox1.
		if(indexToText >= 0)
		{
			// Return the location of the character.
			returnValue = indexToText;
		}
	}

	return returnValue;
}

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