RichTextBox.Find Méthode

Définition

Recherche du texte dans le contenu de RichTextBox.

Surcharges

Find(Char[])

Recherche dans le texte d'un contrôle RichTextBox la première occurrence d'un caractère issu d'une liste.

Find(String)

Recherche une chaîne donnée dans le texte d'un contrôle RichTextBox.

Find(Char[], Int32)

Recherche dans le texte d'un contrôle RichTextBox, à partir d'un point spécifique, la première occurrence d'un caractère parmi une liste de caractères.

Find(String, RichTextBoxFinds)

Recherche une chaîne dans le texte d'un contrôle RichTextBox en appliquant des options de recherche spécifiques.

Find(Char[], Int32, Int32)

Recherche dans une plage de texte d'un contrôle RichTextBox la première occurrence d'un caractère issu d'une liste.

Find(String, Int32, RichTextBoxFinds)

Recherche une chaîne à un emplacement spécifique dans le texte d'un contrôle RichTextBox en appliquant des options de recherche spécifiques.

Find(String, Int32, Int32, RichTextBoxFinds)

Recherche une chaîne dans une plage de texte d'un contrôle RichTextBox en appliquant des options de recherche spécifiques.

Find(Char[])

Recherche dans le texte d'un contrôle RichTextBox la première occurrence d'un caractère issu d'une liste.

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 sont introuvables ou si un jeu de caractères de recherche vide est spécifié dans le paramètre char.

Exemples

L’exemple de code suivant recherche dans le contenu d’un RichTextBox les caractères qui sont passés à la méthode dans le text paramètre . Si le contenu du text tableau se trouve dans , RichTextBoxla méthode retourne l’index de la valeur trouvée ; sinon, elle retourne -1. L’exemple exige que cette méthode soit placée dans la classe d’un Form qui contient un RichTextBox contrôle nommé richTextBox1 et un Button contrôle, nommé button1, qui est 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 le premier 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 transmettez un tableau de caractères contenant le caractère « Q ». Si le contrôle contenait le texte « 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’ensemble du document contenu dans le contrôle soit recherché 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)

Recherche une chaîne donnée dans le texte d'un contrôle RichTextBox.

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 recherché dans le contrôle.

Retours

Emplacement dans le contrôle où le texte recherché a été trouvé ou -1 si la chaîne recherchée est introuvable ou si une chaîne recherchée vide est spécifiée dans le paramètre str.

Exemples

L’exemple de code suivant recherche l’intégralité du contenu d’un RichTextBox pour la première instance d’une chaîne de recherche passée dans le paramètre texte de la méthode. Si la chaîne de recherche se trouve dans , RichTextBoxla méthode retourne une valeur de true et met en surbrillance le texte de recherche, sinon elle retourne false. L’exemple exige que cette méthode soit placée dans la classe d’un Form qui contient un RichTextBox nommé 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.

Notes

Les Find méthodes qui acceptent un string en tant que paramètre ne peuvent pas trouver le texte contenu sur plusieurs lignes de texte dans .RichTextBox L’exécution d’une telle recherche retourne une valeur négative (-1).

S’applique à

Find(Char[], Int32)

Recherche dans le texte d'un contrôle RichTextBox, à partir d'un point spécifique, la première occurrence d'un caractère parmi 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

Position à laquelle débute la recherche dans le texte du contrôle.

Retours

Emplacement du contrôle où les caractères recherchés ont été trouvés.

Exemples

L’exemple de code suivant recherche dans le contenu d’un RichTextBox les caractères qui sont passés à la méthode dans le text paramètre . La recherche commence à partir de l’emplacement dans le RichTextBox spécifié par le start paramètre de la FindMyText méthode. Si le contenu du tableau de texte se trouve dans , RichTextBoxla méthode retourne l’index de la valeur trouvée ; sinon, elle retourne -1. L’exemple exige que cette méthode soit placée dans la classe d’un Form 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 le premier 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 transmettez un tableau de caractères contenant le caractère « Q ». Si le contrôle contenait le texte « 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 que le texte que vous savez déjà ne contient pas les caractères spécifiés que vous recherchez ou qui ne sont pas importants dans votre recherche.

S’applique à

Find(String, RichTextBoxFinds)

Recherche une chaîne dans le texte d'un contrôle RichTextBox en appliquant des options de recherche spécifiques.

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 recherché dans le contrôle.

options
RichTextBoxFinds

Combinaison d’opérations de bits des valeurs RichTextBoxFinds.

Retours

Emplacement du contrôle où le texte recherché a été trouvé.

Exemples

L’exemple de code suivant recherche l’intégralité du contenu d’un RichTextBox pour la première instance d’une chaîne de recherche passée dans le paramètre texte de la méthode. Si la chaîne de recherche se trouve dans , RichTextBoxla méthode retourne une valeur de true et met en surbrillance le texte ; sinon, elle retourne false. L’exemple spécifie également les options de la recherche pour qu’elles correspondent à la casse de la chaîne de recherche spécifiée. L’exemple exige que cette méthode soit placée dans la classe d’un Form qui contient un RichTextBox nommé 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 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 d’étendre 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 par défaut de haut en bas.

Notes

Les Find méthodes qui acceptent un string en tant que paramètre ne peuvent pas trouver le texte contenu sur plusieurs lignes de texte dans .RichTextBox L’exécution d’une telle recherche retourne une valeur négative (-1).

S’applique à

Find(Char[], Int32, Int32)

Recherche dans une plage de texte d'un contrôle RichTextBox la première occurrence d'un caractère issu d'une liste.

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

Position à laquelle débute la recherche dans le texte du contrôle.

end
Int32

Position à laquelle se termine la recherche dans le texte du contrôle.

Retours

Emplacement du contrôle où les caractères recherchés ont été trouvés.

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 le premier 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 transmettez un tableau de caractères contenant le caractère « Q ». Si le contrôle contenait le texte « 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 start paramètres et end . La valeur zéro pour le 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 spécifique de texte dans le contrôle afin d’éviter de rechercher des zones du document qui ne sont pas importantes pour les besoins de votre application.

S’applique à

Find(String, Int32, RichTextBoxFinds)

Recherche une chaîne à un emplacement spécifique dans le texte d'un contrôle RichTextBox en appliquant des options de recherche spécifiques.

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 recherché dans le contrôle.

start
Int32

Position à laquelle débute la recherche dans le texte du contrôle.

options
RichTextBoxFinds

Combinaison d’opérations de bits des valeurs RichTextBoxFinds.

Retours

Emplacement du contrôle où le texte recherché a été trouvé.

Exemples

L’exemple de code suivant recherche l’intégralité du contenu d’un RichTextBox pour la première instance d’une chaîne de recherche passée dans le paramètre 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 se trouve dans , RichTextBoxla 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 les options de la recherche pour qu’elles correspondent à la casse de la chaîne de recherche spécifiée. L’exemple exige que cette méthode soit placée dans la classe d’un Form qui contient un RichTextBox nommé richTextBox1. Vous pouvez utiliser cet exemple pour effectuer une opération de type « Find Next ». 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 d’étendre 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 par défaut de haut en bas. Cette version de la Find méthode vous permet également d’affiner 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 peut-être déjà fait l’objet d’une recherche 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 inversée se termine, car la recherche commence en bas du document lors de l’utilisation de cette version de la Find méthode.

Notes

Les Find méthodes qui acceptent un string en tant que paramètre ne peuvent pas trouver le texte contenu sur plusieurs lignes de texte dans .RichTextBox L’exécution d’une telle recherche retourne une valeur négative (-1).

S’applique à

Find(String, Int32, Int32, RichTextBoxFinds)

Recherche une chaîne dans une plage de texte d'un contrôle RichTextBox en appliquant des options de recherche spécifiques.

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 recherché dans le contrôle.

start
Int32

Position à laquelle débute la recherche dans le texte du contrôle.

end
Int32

Position à laquelle se termine la recherche dans le texte du contrôle. Cette valeur doit être égale à -1 ou supérieure ou égale au paramètre start.

options
RichTextBoxFinds

Combinaison d’opérations de bits des valeurs RichTextBoxFinds.

Retours

Emplacement du contrôle où le texte recherché a été trouvé.

Exceptions

La valeur du paramètre str était null.

Le paramètre start était inférieur à zéro.

- ou -

Le paramètre end était inférieur au paramètre start.

Exemples

L’exemple de code suivant recherche une section de texte dans un RichTextBox pour la première instance d’une chaîne de recherche passée dans le searchText paramètre de la méthode. La plage de recherche de texte dans le contrôle est spécifiée par les searchStart paramètres et searchEnd de la méthode. Si la chaîne de recherche se trouve dans , RichTextBoxla 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 exige que cette méthode soit placée dans la classe d’un Form qui contient un RichTextBox 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 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 d’étendre 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 par défaut de haut en bas. Cette version de la Find méthode vous permet également d’affiner 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 attribuée au paramètre, la end méthode effectue une recherche jusqu’à la fin du texte dans le pour les RichTextBox recherches normales. Pour les recherches inversées, une valeur négative (-1) attribuée au paramètre indique que le end texte sera recherché à partir de la fin du texte (en bas) jusqu’à la position définie par start le paramètre. Lorsque les start paramètres et end sont fournis avec la même valeur, l’ensemble du contrôle est recherché pour les recherches normales. Pour une recherche inversée, l’ensemble du contrôle fait l’objet d’une recherche, mais la recherche commence en bas du document et recherche en haut du document.

Notes

Les Find méthodes qui acceptent un string en tant que paramètre ne peuvent pas trouver le texte contenu sur plusieurs lignes de texte dans .RichTextBox L’exécution d’une telle recherche retourne une valeur négative (-1).

S’applique à