RichTextBox.Find Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Recherche du texte dans le contenu du RichTextBox.
Surcharges
| Nom | Description |
|---|---|
| Find(Char[]) |
Recherche le texte d’un RichTextBox contrôle pour la première instance d’un caractère à partir d’une liste de caractères. |
| Find(String) |
Recherche le texte dans un RichTextBox contrôle pour une chaîne. |
| Find(Char[], Int32) |
Recherche le texte d’un RichTextBox contrôle, à un point de départ spécifique, pour la première instance d’un caractère à partir d’une liste de caractères. |
| Find(String, RichTextBoxFinds) |
Recherche dans un contrôle le texte d’une RichTextBox chaîne avec des options spécifiques appliquées à la recherche. |
| Find(Char[], Int32, Int32) |
Recherche une plage de texte dans un RichTextBox contrôle pour la première instance d’un caractère à partir d’une liste de caractères. |
| Find(String, Int32, RichTextBoxFinds) |
Recherche dans un contrôle le texte d’une RichTextBox chaîne à un emplacement spécifique dans le contrôle et avec des options spécifiques appliquées à la recherche. |
| Find(String, Int32, Int32, RichTextBoxFinds) |
Recherche dans un contrôle le texte d’une RichTextBox chaîne dans une plage de texte dans le contrôle et avec des options spécifiques appliquées à la recherche. |
Find(Char[])
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
Recherche le texte d’un RichTextBox contrôle pour la première instance d’un caractère à partir d’une liste de caractères.
public:
int Find(cli::array <char> ^ characterSet);
public int Find(char[] characterSet);
member this.Find : char[] -> int
Public Function Find (characterSet As Char()) As Integer
Paramètres
- characterSet
- Char[]
Tableau de caractères à rechercher.
Retours
Emplacement dans le contrôle où les caractères de recherche ont été trouvés ou -1 si les caractères de recherche ne sont pas trouvés ou si un jeu de caractères de recherche vide est spécifié dans le char paramètre.
Exemples
L’exemple de code suivant recherche le contenu d’un RichTextBox caractère transmis à la méthode dans le text paramètre. Si le contenu du text tableau est trouvé dans le RichTextBoxtableau, la méthode retourne l’index de la valeur trouvée ; sinon, elle retourne -1. L’exemple nécessite que cette méthode soit placée dans la classe d’un Form contrôle qui contient un RichTextBox contrôle nommé richTextBox1 et un Button contrôle, nommé button1, connecté au Click gestionnaire d’événements défini dans l’exemple.
private:
void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
array<Char>^temp1 = {'D','e','l','t','a'};
MessageBox::Show( FindMyText( temp1 ).ToString() );
}
public:
int FindMyText( array<Char>^text )
{
// 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 )
{
// 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 );
// Determine whether the text was found in richTextBox1.
if ( indexToText >= 0 )
{
// Return the location of the character.
returnValue = indexToText;
}
}
return returnValue;
}
private void button1_Click(object sender, System.EventArgs e)
{
MessageBox.Show(FindMyText(new char[]{'D','e','l','t','a'}).ToString());
}
public int FindMyText(char[] text)
{
// 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)
{
// 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);
// Determine whether the text was found in richTextBox1.
if(indexToText >= 0)
{
// Return the location of the character.
returnValue = indexToText;
}
}
return returnValue;
}
Private Sub button1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button1.Click
MessageBox.Show(FindMyText(New Char() {"B"c, "r"c, "a"c, "v"c, "o"c}).ToString())
End Sub
Public Function FindMyText(ByVal [text]() As Char) 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 Then
' Obtain the location of the first character found in the control
' that matches any of the characters in the char array.
Dim indexToText As Integer = richTextBox1.Find([text])
' Determine whether the text was found in richTextBox1.
If indexToText >= 0 Then
' Return the location of the character.
returnValue = indexToText
End If
End If
Return returnValue
End Function
Remarques
Cette version de la Find méthode recherche la première instance d’un caractère à partir d’une liste de caractères spécifiés dans le characterSet paramètre et retourne l’emplacement du caractère. Par exemple, vous passez un tableau de caractères contenant le caractère « Q ». Si le contrôle contenait le texte « The Quick Brown Fox », la Find méthode retournerait la valeur de quatre. Un caractère majuscule et un caractère minuscule sont considérés comme des valeurs différentes dans la recherche.
Si la propriété retourne une valeur négative, les caractères recherchés n’ont pas été trouvés dans le contenu du contrôle. Vous pouvez utiliser cette méthode pour rechercher un groupe de caractères dans le contrôle. Cette version de la Find méthode nécessite que l’intégralité du document contenu dans le contrôle soit recherchée pour les caractères. Si un caractère de la liste de caractères fournie dans le paramètre de characterSet la méthode est trouvé, la valeur retournée par cette méthode est un index de base zéro de la position du caractère dans le contrôle. Un espace est considéré comme un caractère par la méthode lors de la détermination de l’emplacement d’un caractère.
S’applique à
Find(String)
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
Recherche le texte dans un RichTextBox contrôle pour une chaîne.
public:
int Find(System::String ^ str);
public int Find(string str);
member this.Find : string -> int
Public Function Find (str As String) As Integer
Paramètres
- str
- String
Texte à localiser dans le contrôle.
Retours
Emplacement dans le contrôle où le texte de recherche a été trouvé ou -1 si la chaîne de recherche est introuvable ou si une chaîne de recherche vide est spécifiée dans le str paramètre.
Exemples
L’exemple de code suivant recherche l’intégralité du contenu d’une RichTextBox première instance d’une chaîne de recherche passée dans le paramètre de texte de la méthode. Si la chaîne de recherche est trouvée dans le RichTextBox, la méthode retourne une valeur de et met en surbrillance le texte de true recherche, sinon elle retourne false. L’exemple nécessite que cette méthode soit placée dans la classe d’un Form qui contient un RichTextBox nom 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;
}
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;
}
Public Function FindMyText(text As String) As Boolean
' Initialize the return value to false by default.
Dim returnValue As Boolean = False
' Ensure a search string has been specified.
If text.Length > 0 Then
' Obtain the location of the search string in richTextBox1.
Dim indexToText As Integer = richTextBox1.Find(text)
' Determine whether the text was found in richTextBox1.
If indexToText >= 0 Then
returnValue = True
End If
End If
Return returnValue
End Function
Remarques
La Find méthode recherche le texte spécifié dans le str paramètre et retourne l’emplacement du premier caractère dans le contrôle. Si la propriété retourne une valeur négative, la chaîne de texte recherchée n’a pas été trouvée dans le contenu du contrôle. Vous pouvez utiliser cette méthode pour créer des fonctionnalités de recherche qui peuvent être fournies à l’utilisateur du contrôle. Vous pouvez également utiliser cette méthode pour rechercher du texte à remplacer par un format spécifique. Par exemple, si l’utilisateur a entré des dates dans le contrôle, vous pouvez utiliser la Find méthode pour rechercher toutes les dates dans le document et les remplacer par le format approprié avant d’utiliser la SaveFile méthode du contrôle.
Note
Les Find méthodes qui acceptent un string paramètre ne peuvent pas trouver de texte contenu sur plusieurs lignes de texte dans le RichTextBox. L’exécution d’une telle recherche retourne une valeur négative (-1).
S’applique à
Find(Char[], Int32)
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
Recherche le texte d’un RichTextBox contrôle, à un point de départ spécifique, pour la première instance d’un caractère à partir d’une liste de caractères.
public:
int Find(cli::array <char> ^ characterSet, int start);
public int Find(char[] characterSet, int start);
member this.Find : char[] * int -> int
Public Function Find (characterSet As Char(), start As Integer) As Integer
Paramètres
- characterSet
- Char[]
Tableau de caractères à rechercher.
- start
- Int32
Emplacement dans le texte du contrôle auquel commencer la recherche.
Retours
Emplacement dans le contrôle où se trouvent les caractères de recherche.
Exemples
L’exemple de code suivant recherche le contenu d’un RichTextBox caractère transmis à la méthode dans le text paramètre. La recherche commence à partir de l’emplacement dans le RichTextBox paramètre spécifié par la startFindMyText méthode. Si le contenu du tableau de texte est trouvé dans le RichTextBoxtableau de texte, la méthode retourne l’index de la valeur trouvée ; sinon, elle retourne -1. L’exemple nécessite que cette méthode soit placée dans la classe d’un Form contrôle qui contient un RichTextBox contrôle nommé richTextBox1 et un Button contrôle nommé button1 connecté au Click gestionnaire d’événements défini dans l’exemple.
private:
void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
array<Char>^temp0 = {'B','r','a','v','o'};
MessageBox::Show( FindMyText( temp0, 5 ).ToString() );
}
public:
int FindMyText( array<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;
}
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;
}
Private Sub button1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button1.Click
MessageBox.Show(FindMyText(New Char() {"B"c, "r"c, "a"c, "v"c, "o"c}, 5).ToString())
End Sub
Public Function FindMyText(ByVal text() As Char, ByVal start As Integer) As Integer
' Initialize the return value to false by default.
Dim returnValue As Integer = -1
' Ensure that a valid char array has been specified and a valid start point.
If [text].Length > 0 And start >= 0 Then
' Obtain the location of the first character found in the control
' that matches any of the characters in the char array.
Dim indexToText As Integer = richTextBox1.Find([text], start)
' Determine whether any of the chars are found in richTextBox1.
If indexToText >= 0 Then
' Return the location of the character.
returnValue = indexToText
End If
End If
Return returnValue
End Function
Remarques
Cette version de la Find méthode recherche la première instance d’un caractère à partir d’une liste de caractères spécifiés dans le characterSet paramètre et retourne l’emplacement du caractère. Par exemple, vous passez un tableau de caractères contenant le caractère « Q ». Si le contrôle contenait le texte « The Quick Brown Fox », la Find méthode retournerait la valeur de quatre. Un caractère majuscule et un caractère minuscule sont considérés comme des valeurs différentes dans la recherche.
Si la propriété retourne une valeur négative, les caractères recherchés n’ont pas été trouvés dans le contenu du contrôle. Vous pouvez utiliser cette méthode pour rechercher un groupe de caractères dans le contrôle. Si un caractère de la liste de caractères fournie dans le paramètre de characterSet la méthode est trouvé, la valeur retournée par cette méthode est un index de base zéro de la position du caractère dans le contrôle. Un espace est considéré comme un caractère par la méthode lors de la détermination de l’emplacement d’un caractère.
Cette version de la Find méthode vous permet de rechercher un jeu de caractères à partir d’une position de début spécifiée dans le texte du contrôle en spécifiant une valeur pour le start paramètre. La valeur zéro indique que la recherche doit commencer à partir du début du document du contrôle. Vous pouvez utiliser cette version de la Find méthode pour affiner votre recherche afin d’éviter le texte que vous savez déjà ne contient pas les caractères spécifiés que vous recherchez ou ne sont pas importants dans votre recherche.
S’applique à
Find(String, RichTextBoxFinds)
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
Recherche dans un contrôle le texte d’une RichTextBox chaîne avec des options spécifiques appliquées à la recherche.
public:
int Find(System::String ^ str, System::Windows::Forms::RichTextBoxFinds options);
public int Find(string str, System.Windows.Forms.RichTextBoxFinds options);
member this.Find : string * System.Windows.Forms.RichTextBoxFinds -> int
Public Function Find (str As String, options As RichTextBoxFinds) As Integer
Paramètres
- str
- String
Texte à localiser dans le contrôle.
- options
- RichTextBoxFinds
Combinaison au niveau du bit des RichTextBoxFinds valeurs.
Retours
Emplacement dans le contrôle où le texte de recherche a été trouvé.
Exemples
L’exemple de code suivant recherche l’intégralité du contenu d’une RichTextBox première instance d’une chaîne de recherche passée dans le paramètre de texte de la méthode. Si la chaîne de recherche est trouvée dans le RichTextBox, la méthode retourne une valeur de true et met en surbrillance le texte ; sinon, elle retourne false. L’exemple spécifie également des options dans la recherche pour qu’elles correspondent à la casse de la chaîne de recherche spécifiée. L’exemple nécessite que cette méthode soit placée dans la classe d’un Form qui contient un RichTextBox nom 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;
}
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;
}
Public Function FindMyText(text As String) As Boolean
' Initialize the return value to false by default.
Dim returnValue As Boolean = False
' Ensure a search string has been specified.
If text.Length > 0 Then
' Obtain the location of the search string in richTextBox1.
Dim indexToText As Integer = richTextBox1.Find(text, RichTextBoxFinds.MatchCase)
' Determine if the text was found in richTextBox1.
If indexToText >= 0 Then
returnValue = True
End If
End If
Return returnValue
End Function
Remarques
La Find méthode recherche le texte spécifié dans le str paramètre et retourne l’emplacement du premier caractère dans le contrôle. Si la propriété retourne une valeur négative, la chaîne de texte recherchée n’a pas été trouvée dans le contenu du contrôle. Vous pouvez utiliser cette méthode pour créer des fonctionnalités de recherche qui peuvent être fournies à l’utilisateur du contrôle. Vous pouvez également utiliser cette méthode pour rechercher du texte à remplacer par un format spécifique. Par exemple, si l’utilisateur a entré des dates dans le contrôle, vous pouvez utiliser la Find méthode pour rechercher toutes les dates du document et les remplacer par le format approprié avant d’utiliser la SaveFile méthode du contrôle.
Avec cette version de la Find méthode, vous pouvez spécifier des options qui vous permettent de développer ou d’affiner votre recherche. Vous pouvez spécifier des options qui vous permettent de faire correspondre la casse du mot de recherche ou de rechercher des mots entiers au lieu de mots partiels. En spécifiant l’énumération RichTextBoxFinds.Reverse dans le options paramètre, vous pouvez rechercher du texte du bas du document vers le haut au lieu de la méthode de recherche supérieure à inférieure par défaut.
Note
Les Find méthodes qui acceptent un string paramètre ne peuvent pas trouver de texte contenu sur plusieurs lignes de texte dans le RichTextBox. L’exécution d’une telle recherche retourne une valeur négative (-1).
S’applique à
Find(Char[], Int32, Int32)
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
Recherche une plage de texte dans un RichTextBox contrôle pour la première instance d’un caractère à partir d’une liste de caractères.
public:
int Find(cli::array <char> ^ characterSet, int start, int end);
public int Find(char[] characterSet, int start, int end);
member this.Find : char[] * int * int -> int
Public Function Find (characterSet As Char(), start As Integer, end As Integer) As Integer
Paramètres
- characterSet
- Char[]
Tableau de caractères à rechercher.
- start
- Int32
Emplacement dans le texte du contrôle auquel commencer la recherche.
- end
- Int32
Emplacement dans le texte du contrôle auquel terminer la recherche.
Retours
Emplacement dans le contrôle où se trouvent les caractères de recherche.
Exceptions
characterSet a la valeur null.
start est inférieur à 0 ou supérieur à la longueur du texte dans le contrôle.
Remarques
Cette version de la Find méthode recherche la première instance d’un caractère à partir d’une liste de caractères spécifiés dans le characterSet paramètre et retourne l’emplacement du caractère. Par exemple, vous passez un tableau de caractères contenant le caractère « Q ». Si le contrôle contenait le texte « The Quick Brown Fox », la Find méthode retournerait la valeur de quatre. Un caractère majuscule et un caractère minuscule sont considérés comme des valeurs différentes dans la recherche.
Si la propriété retourne une valeur négative, les caractères recherchés n’ont pas été trouvés dans le contenu du contrôle. Vous pouvez utiliser cette méthode pour rechercher un groupe de caractères dans le contrôle. Si un caractère de la liste de caractères fournie dans le paramètre de characterSet la méthode est trouvé, la valeur retournée par cette méthode est un index de base zéro de la position du caractère dans le contrôle. Un espace est considéré comme un caractère par la méthode lors de la détermination de l’emplacement d’un caractère.
Cette version de la Find méthode vous permet de rechercher un jeu de caractères à partir d’une plage de texte dans le contrôle en spécifiant une valeur pour les paramètres et start les end paramètres. La valeur zéro du start paramètre indique que la recherche doit commencer à partir du début du document du contrôle. Une valeur -1 pour le end paramètre indique que la recherche doit se terminer à la fin du texte dans le contrôle. Vous pouvez utiliser cette version de la Find méthode pour limiter votre recherche à une plage de texte spécifique dans le contrôle pour éviter de rechercher des zones du document qui ne sont pas importantes pour les besoins de votre application.
S’applique à
Find(String, Int32, RichTextBoxFinds)
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
Recherche dans un contrôle le texte d’une RichTextBox chaîne à un emplacement spécifique dans le contrôle et avec des options spécifiques appliquées à la recherche.
public:
int Find(System::String ^ str, int start, System::Windows::Forms::RichTextBoxFinds options);
public int Find(string str, int start, System.Windows.Forms.RichTextBoxFinds options);
member this.Find : string * int * System.Windows.Forms.RichTextBoxFinds -> int
Public Function Find (str As String, start As Integer, options As RichTextBoxFinds) As Integer
Paramètres
- str
- String
Texte à localiser dans le contrôle.
- start
- Int32
Emplacement dans le texte du contrôle auquel commencer la recherche.
- options
- RichTextBoxFinds
Combinaison au niveau du bit des RichTextBoxFinds valeurs.
Retours
Emplacement dans le contrôle où le texte de recherche a été trouvé.
Exemples
L’exemple de code suivant recherche l’intégralité du contenu d’une RichTextBox première instance d’une chaîne de recherche passée dans le paramètre de texte de la méthode. L’emplacement de départ de la recherche est spécifié par le paramètre de début de la méthode. Si la chaîne de recherche est trouvée dans le RichTextBox, la méthode retourne l’emplacement d’index du premier caractère du texte trouvé et met en surbrillance le texte trouvé ; sinon, elle retourne une valeur de -1. L’exemple spécifie également des options dans la recherche pour qu’elles correspondent à la casse de la chaîne de recherche spécifiée. L’exemple nécessite que cette méthode soit placée dans la classe d’un Form qui contient un RichTextBox nom richTextBox1. Vous pouvez utiliser cet exemple pour effectuer un type d’opération « Rechercher suivant ». Une fois qu’une instance du texte de recherche a été trouvée, vous pouvez trouver d’autres instances du texte en modifiant la valeur du start paramètre pour effectuer une recherche à un emplacement au-delà de la position de la correspondance actuelle.
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
Remarques
La Find méthode recherche le texte spécifié dans le str paramètre et retourne l’emplacement du premier caractère de la chaîne de recherche dans le contrôle. Si la propriété retourne une valeur négative, la chaîne de texte recherchée n’a pas été trouvée dans le contenu du contrôle. Vous pouvez utiliser cette méthode pour créer des fonctionnalités de recherche qui peuvent être fournies à l’utilisateur du contrôle. Vous pouvez également utiliser cette méthode pour rechercher du texte à remplacer par un format spécifique. Par exemple, si l’utilisateur a entré des dates dans le contrôle, vous pouvez utiliser la Find méthode pour rechercher toutes les dates dans le document et les remplacer par le format approprié avant d’utiliser la SaveFile méthode du contrôle.
Avec cette version de la Find méthode, vous pouvez spécifier des options qui vous permettent de développer ou d’affiner votre recherche. Vous pouvez spécifier des options qui vous permettent de faire correspondre la casse du mot de recherche ou de rechercher des mots entiers au lieu de mots partiels. En spécifiant l’énumération RichTextBoxFinds.Reverse dans le options paramètre, vous pouvez rechercher du texte du bas du document vers le haut au lieu de la méthode de recherche supérieure à inférieure par défaut. Cette version de la Find méthode vous permet également de limiter la recherche de texte en sélectionnant une position de départ spécifique dans le texte du contrôle. Cette fonctionnalité peut vous permettre d’éviter le texte qui a déjà été recherché ou où le texte spécifique que vous recherchez n’existe pas. Lorsque la RichTextBoxFinds.Reverse valeur est spécifiée dans le options paramètre, la valeur du start paramètre indique la position où la recherche inverse se termine, car la recherche commence au bas du document lors de l’utilisation de cette version de la Find méthode.
Note
Les Find méthodes qui acceptent un string paramètre ne peuvent pas trouver de texte contenu sur plusieurs lignes de texte dans le RichTextBox. L’exécution d’une telle recherche retourne une valeur négative (-1).
S’applique à
Find(String, Int32, Int32, RichTextBoxFinds)
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
- Source:
- RichTextBox.cs
Recherche dans un contrôle le texte d’une RichTextBox chaîne dans une plage de texte dans le contrôle et avec des options spécifiques appliquées à la recherche.
public:
int Find(System::String ^ str, int start, int end, System::Windows::Forms::RichTextBoxFinds options);
public int Find(string str, int start, int end, System.Windows.Forms.RichTextBoxFinds options);
member this.Find : string * int * int * System.Windows.Forms.RichTextBoxFinds -> int
Public Function Find (str As String, start As Integer, end As Integer, options As RichTextBoxFinds) As Integer
Paramètres
- str
- String
Texte à localiser dans le contrôle.
- start
- Int32
Emplacement dans le texte du contrôle auquel commencer la recherche.
- end
- Int32
Emplacement dans le texte du contrôle auquel terminer la recherche. Cette valeur doit être égale à négative (-1) ou supérieure ou égale au start paramètre.
- options
- RichTextBoxFinds
Combinaison au niveau du bit des RichTextBoxFinds valeurs.
Retours
Emplacement dans le contrôle où le texte de recherche a été trouvé.
Exceptions
Le str paramètre était null.
Le start paramètre était inférieur à zéro.
- ou -
Le end paramètre était moins le start paramètre.
Exemples
L’exemple de code suivant recherche une section de texte dans une RichTextBox première instance d’une chaîne de recherche passée dans le searchText paramètre de la méthode. La plage à rechercher du texte dans le contrôle est spécifiée par les paramètres et searchStart les searchEnd paramètres de la méthode. Si la chaîne de recherche est trouvée dans le RichTextBox, la méthode retourne l’emplacement d’index du premier caractère du texte trouvé et met en surbrillance le texte trouvé ; sinon, elle retourne une valeur de -1. L’exemple utilise également le options paramètre de la Find méthode pour spécifier que le texte trouvé doit correspondre à la casse de la chaîne de recherche. L’exemple nécessite que cette méthode soit placée dans la classe d’un FormRichTextBox contrôle nommé richTextBox1. Une fois la première instance de la chaîne de recherche trouvée, vous pouvez utiliser cet exemple pour rechercher d’autres instances dans le texte.
public:
int FindMyText( String^ searchText, int searchStart, int searchEnd )
{
// Initialize the return value to false by default.
int returnValue = -1;
// Ensure that a search string and a valid starting point are specified.
if ( searchText->Length > 0 && searchStart >= 0 )
{
// Ensure that a valid ending value is provided.
if ( searchEnd > searchStart || searchEnd == -1 )
{
// Obtain the location of the search string in richTextBox1.
int indexToText = richTextBox1->Find( searchText, searchStart, searchEnd, RichTextBoxFinds::MatchCase );
// Determine whether the text was found in richTextBox1.
if ( indexToText >= 0 )
{
// Return the index to the specified search text.
returnValue = indexToText;
}
}
}
return returnValue;
}
public int FindMyText(string searchText, int searchStart, int searchEnd)
{
// Initialize the return value to false by default.
int returnValue = -1;
// Ensure that a search string and a valid starting point are specified.
if (searchText.Length > 0 && searchStart >= 0)
{
// Ensure that a valid ending value is provided.
if (searchEnd > searchStart || searchEnd == -1)
{
// Obtain the location of the search string in richTextBox1.
int indexToText = richTextBox1.Find(searchText, searchStart, searchEnd, RichTextBoxFinds.MatchCase);
// Determine whether the text was found in richTextBox1.
if(indexToText >= 0)
{
// Return the index to the specified search text.
returnValue = indexToText;
}
}
}
return returnValue;
}
Public Function FindMyText(ByVal searchText As String, ByVal searchStart As Integer, ByVal searchEnd As Integer) As Integer
' Initialize the return value to false by default.
Dim returnValue As Integer = -1
' Ensure that a search string and a valid starting point are specified.
If searchText.Length > 0 And searchStart >= 0 Then
' Ensure that a valid ending value is provided.
If searchEnd > searchStart Or searchEnd = -1 Then
' Obtain the location of the search string in richTextBox1.
Dim indexToText As Integer = richTextBox1.Find(searchText, searchStart, searchEnd, RichTextBoxFinds.MatchCase)
' Determine whether the text was found in richTextBox1.
If indexToText >= 0 Then
' Return the index to the specified search text.
returnValue = indexToText
End If
End If
End If
Return returnValue
End Function
Remarques
La Find méthode recherche le texte spécifié dans le str paramètre et retourne l’emplacement du premier caractère de la chaîne de recherche dans le contrôle. Si la propriété retourne une valeur négative, la chaîne de texte recherchée n’a pas été trouvée dans le contenu du contrôle. Vous pouvez utiliser cette méthode pour créer des fonctionnalités de recherche qui peuvent être fournies à l’utilisateur du contrôle. Vous pouvez également utiliser cette méthode pour rechercher du texte à remplacer par un format spécifique. Par exemple, si l’utilisateur a entré des dates dans le contrôle, vous pouvez utiliser la Find méthode pour rechercher toutes les dates du document et les remplacer par le format approprié avant d’utiliser la SaveFile méthode du contrôle.
Avec cette version de la Find méthode, vous pouvez spécifier des options qui vous permettent de développer ou d’affiner votre recherche. Vous pouvez spécifier des options qui vous permettent de faire correspondre la casse du mot de recherche ou de rechercher des mots entiers au lieu de mots partiels. En spécifiant l’énumération RichTextBoxFinds.Reverse dans le options paramètre, vous pouvez rechercher du texte du bas du document vers le haut au lieu de la méthode de recherche supérieure à inférieure par défaut. Cette version de la Find méthode vous permet également de limiter la recherche de texte en sélectionnant une position de début et de fin spécifique dans le texte du contrôle. Cette fonctionnalité peut vous permettre de limiter la plage de recherche à une section spécifique du texte du contrôle. Si une valeur négative (-1) est affectée au end paramètre, la méthode effectue une recherche jusqu’à la fin du texte dans les RichTextBox recherches normales. Pour les recherches inversées, une valeur négative (-1) affectée au paramètre indique que le end texte sera recherché de la fin du texte (en bas) à la position définie par start paramètre. Lorsque les paramètres et start les end paramètres sont fournis la même valeur, l’ensemble du contrôle est recherché pour rechercher des recherches normales. Pour une recherche inversée, l’ensemble du contrôle est recherché, mais la recherche commence en bas du document et effectue des recherches en haut du document.
Note
Les Find méthodes qui acceptent un string paramètre ne peuvent pas trouver de texte contenu sur plusieurs lignes de texte dans le RichTextBox. L’exécution d’une telle recherche retourne une valeur négative (-1).