RichTextBox.Find RichTextBox.Find RichTextBox.Find RichTextBox.Find Method

Définition

Recherche du texte dans le contenu de RichTextBox.Searches for text within the contents of the RichTextBox.

Surcharges

Find(String, Int32, Int32, RichTextBoxFinds) Find(String, Int32, Int32, RichTextBoxFinds) Find(String, Int32, Int32, RichTextBoxFinds) 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.Searches the text in a RichTextBox control for a string within a range of text within the control and with specific options applied to the search.

Find(String, Int32, RichTextBoxFinds) Find(String, Int32, RichTextBoxFinds) Find(String, Int32, RichTextBoxFinds) 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.Searches the text in a RichTextBox control for a string at a specific location within the control and with specific options applied to the search.

Find(Char[], Int32, Int32) Find(Char[], Int32, Int32) Find(Char[], Int32, Int32) 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.Searches a range of text in a RichTextBox control for the first instance of a character from a list of characters.

Find(Char[]) Find(Char[]) Find(Char[]) Find(Char[])

Recherche dans le texte d'un contrôle RichTextBox la première occurrence d'un caractère issu d'une liste.Searches the text of a RichTextBox control for the first instance of a character from a list of characters.

Find(Char[], Int32) Find(Char[], Int32) Find(Char[], Int32) 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.Searches the text of a RichTextBox control, at a specific starting point, for the first instance of a character from a list of characters.

Find(String) Find(String) Find(String) Find(String)

Recherche une chaîne donnée dans le texte d'un contrôle RichTextBox.Searches the text in a RichTextBox control for a string.

Find(String, RichTextBoxFinds) Find(String, RichTextBoxFinds) Find(String, RichTextBoxFinds) Find(String, RichTextBoxFinds)

Recherche une chaîne dans le texte d'un contrôle RichTextBox en appliquant des options de recherche spécifiques.Searches the text in a RichTextBox control for a string with specific options applied to the search.

Find(String, Int32, Int32, RichTextBoxFinds) Find(String, Int32, Int32, RichTextBoxFinds) Find(String, Int32, Int32, RichTextBoxFinds) 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.Searches the text in a RichTextBox control for a string within a range of text within the control and with specific options applied to the search.

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 String String String

Texte recherché dans le contrôle.The text to locate in the control.

start
Int32 Int32 Int32 Int32

Position à laquelle débute la recherche dans le texte du contrôle.The location within the control's text at which to begin searching.

end
Int32 Int32 Int32 Int32

Position à laquelle se termine la recherche dans le texte du contrôle.The location within the control's text at which to end searching. Cette valeur doit être égale à -1 ou supérieure ou égale au paramètre start.This value must be equal to negative one (-1) or greater than or equal to the start parameter.

options
RichTextBoxFinds RichTextBoxFinds RichTextBoxFinds RichTextBoxFinds

Combinaison d'opérations de bits des valeurs RichTextBoxFinds.A bitwise combination of the RichTextBoxFinds values.

Retours

Emplacement du contrôle où le texte recherché a été trouvé.The location within the control where the search text was found.

Exceptions

La valeur du paramètre str était null.The str parameter was null.

Le paramètre start était inférieur à zéro.The start parameter was less than zero.

ou-or- Le paramètre end était inférieur au paramètre start.The end parameter was less the start parameter.

Exemples

L’exemple de code suivant recherche une section de texte dans RichTextBox un pour la première instance d’une chaîne de recherche passée searchText dans le paramètre de la méthode.The following code example searches a section of text in a RichTextBox for the first instance of a search string passed into the searchText parameter of the method. La plage dans laquelle rechercher du texte dans le contrôle est spécifiée par searchStart les searchEnd paramètres et de la méthode.The range to search for text within the control is specified by the searchStart and searchEnd parameters of the method. Si la chaîne recherchée est trouvée RichTextBoxdans le, 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 la valeur-1.If the search string is found in the RichTextBox, the method returns the index location of the first character of the found text and highlights the found text; otherwise, it returns a value of -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.The example also uses the options parameter of the Find method to specify that the found text should match the case of the search string. L’exemple requiert que cette méthode soit placée dans la classe d’un Form qui contient un RichTextBox contrôle nommé richTextBox1.The example requires that this method is placed in the class of a Form that contains a RichTextBox control named richTextBox1. Une fois que la première instance de la chaîne recherchée a été trouvée, vous pouvez utiliser cet exemple pour rechercher d’autres instances dans le texte.After the first instance of the search string has been found, you can use this example to find other instances in the text.

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 recherchée dans le contrôle.The Find method searches for the text specified in the str parameter and returns the location of the first character of the search string within the control. Si la propriété retourne une valeur négative, la chaîne de texte recherchée est introuvable dans le contenu du contrôle.If the property returns a negative value, the text string being searched for was not found within the contents of the control. Vous pouvez utiliser cette méthode pour créer des fonctionnalités de recherche qui peuvent être fournies à l’utilisateur du contrôle.You can use this method to create search functionality that can be provided to the user of the control. Vous pouvez également utiliser cette méthode pour rechercher du texte à remplacer par un format spécifique.You can also use this method to search for text to be replaced with a specific format. Par exemple, si l’utilisateur a entré des dates dans le contrôle, vous pouvez Find utiliser la méthode pour rechercher toutes les dates dans le document et les remplacer par le format approprié avant SaveFile d’utiliser la méthode du contrôle.For example, if the user entered dates into the control, you can use the Find method to search for all dates in the document and replace them with the appropriate format before using the SaveFile method of the control.

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.With this version of the Find method, you can specify options that enable you to expand or narrow your search. Vous pouvez spécifier des options qui vous permettent de mettre en correspondance la casse du mot recherché ou de rechercher des mots entiers plutôt que des mots partiels.You can specify options that enable you to match the casing of the search word or to search for entire words instead of partial words. En spécifiant RichTextBoxFinds.Reverse l’énumération options dans le paramètre, vous pouvez rechercher du texte à partir du bas du document vers le haut au lieu de la méthode de recherche de haut en bas par défaut.By specifying the RichTextBoxFinds.Reverse enumeration in the options parameter, you can search for text from the bottom of the document to the top instead of the default top to bottom search method. 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.This version of the Find method also enables you to narrow the search for text by selecting a specific start and end position within the control's text. Cette fonctionnalité peut vous permettre de limiter la plage de recherche à une section spécifique du texte du contrôle.This feature can enable you to limit the search range to a specific section of the control's text. Si une valeur négative (-1) est assignée au end paramètre, la méthode effectue une recherche jusqu’à la fin du texte du pour les RichTextBox recherches normales.If a value of negative one (-1) is assigned to the end parameter, the method will search until the end of the text in the RichTextBox for normal searches. Pour les recherches inversées, la valeur moins un (-1) affectée end au paramètre indique que le texte sera recherché à partir de la fin du texte (bas) jusqu' start à la position définie par le paramètre.For reverse searches, a value of negative one (-1) assigned to the end parameter indicates that text will be searched from the end of text (bottom) to the position defined by start parameter. Lorsque les start paramètres end et ont la même valeur, l’intégralité du contrôle est recherchée dans les recherches normales.When the start and end parameters are provided the same value the entire control is searched for normal searches. Dans le cas d’une recherche inversée, le contrôle est recherché dans son intégralité, mais la recherche commence au bas du document et effectue une recherche en haut du document.For a reverse search, the entire control is searched but the search begins at the bottom of the document and searches to the top of the document.

Notes

Les Find méthodes qui acceptent un string comme paramètre ne peuvent pas rechercher le texte contenu dans plusieurs lignes de texte dans le RichTextBox.The Find methods that accept a string as a parameter cannot find text that is contained on more than one line of text within the RichTextBox. Une telle recherche retourne une valeur négative 1 (-1).Performing such a search will return a value of negative one (-1).

Find(String, Int32, RichTextBoxFinds) Find(String, Int32, RichTextBoxFinds) Find(String, Int32, RichTextBoxFinds) 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.Searches the text in a RichTextBox control for a string at a specific location within the control and with specific options applied to the search.

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 String String String

Texte recherché dans le contrôle.The text to locate in the control.

start
Int32 Int32 Int32 Int32

Position à laquelle débute la recherche dans le texte du contrôle.The location within the control's text at which to begin searching.

options
RichTextBoxFinds RichTextBoxFinds RichTextBoxFinds RichTextBoxFinds

Combinaison d'opérations de bits des valeurs RichTextBoxFinds.A bitwise combination of the RichTextBoxFinds values.

Retours

Emplacement du contrôle où le texte recherché a été trouvé.The location within the control where the search text was found.

Exemples

L’exemple de code suivant recherche dans l’ensemble du RichTextBox contenu d’un pour la première instance d’une chaîne de recherche passée dans le paramètre text de la méthode.The following code example searches the entire contents of a RichTextBox for the first instance of a search string passed into the text parameter of the method. L’emplacement de départ de la recherche est spécifié par le paramètre Start de la méthode.The search starting location is specified by the start parameter of the method. Si la chaîne recherchée est trouvée RichTextBoxdans le, 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 la valeur-1.If the search string is found in the RichTextBox, the method returns the index location of the first character of the found text and highlights the found text; otherwise, it returns a value of -1. L’exemple spécifie également les options de recherche qui correspondent à la casse de la chaîne de recherche spécifiée.The example also specifies options in the search to match the case of the specified search string. L’exemple requiert que cette méthode soit placée dans la classe d’un Form qui contient un RichTextBox nommé richTextBox1.The example requires that this method is placed in the class of a Form that contains a RichTextBox named richTextBox1. Vous pouvez utiliser cet exemple pour effectuer un type d’opération « Rechercher suivant ».You can use this example to perform a "Find Next" type of operation. Une fois qu’une instance du texte recherché a été trouvée, vous pouvez trouver d’autres instances du texte en modifiant la valeur start du paramètre pour effectuer une recherche à un emplacement situé au-delà de la position de la correspondance actuelle.Once an instance of the search text has been found, you can find other instances of the text by changing the value of the start parameter to search at a location beyond the position of the current match.

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 recherchée dans le contrôle.The Find method searches for the text specified in the str parameter and returns the location of the first character of the search string within the control. Si la propriété retourne une valeur négative, la chaîne de texte recherchée est introuvable dans le contenu du contrôle.If the property returns a negative value, the text string being searched for was not found within the contents of the control. Vous pouvez utiliser cette méthode pour créer des fonctionnalités de recherche qui peuvent être fournies à l’utilisateur du contrôle.You can use this method to create search functionality that can be provided to the user of the control. Vous pouvez également utiliser cette méthode pour rechercher du texte à remplacer par un format spécifique.You can also use this method to search for text to be replaced with a specific format. Par exemple, si l’utilisateur a entré des dates dans le contrôle, vous pouvez Find utiliser la méthode pour rechercher toutes les dates dans le document et les remplacer par le format approprié avant SaveFile d’utiliser la méthode du contrôle.For example, if the user entered dates into the control, you could use the Find method to search for all dates in the document and replace them with the appropriate format before using the SaveFile method of the control.

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.With this version of the Find method, you can specify options that enable you to expand or narrow your search. Vous pouvez spécifier des options qui vous permettent de mettre en correspondance la casse du mot recherché ou de rechercher des mots entiers plutôt que des mots partiels.You can specify options that enable you to match the casing of the search word or to search for entire words instead of partial words. En spécifiant RichTextBoxFinds.Reverse l’énumération options dans le paramètre, vous pouvez rechercher du texte à partir du bas du document vers le haut au lieu de la méthode de recherche de haut en bas par défaut.By specifying the RichTextBoxFinds.Reverse enumeration in the options parameter, you can search for text from the bottom of the document to the top instead of the default top to bottom search method. 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.This version of the Find method also enables you to narrow the search for text by selecting a specific starting position within the control's text. Cette fonctionnalité peut vous permettre d’éviter le texte qui a déjà été recherché ou l’emplacement du texte spécifique que vous recherchez.This feature can enable you to avoid text that might have already been searched or where the specific text you are searching for is known not to exist. Lorsque la RichTextBoxFinds.Reverse valeur est spécifiée dans le options paramètre start , la valeur du paramètre indique la position à laquelle la recherche inversée se termine, car la recherche commence au bas du document lors de l’utilisation de cette version du Find méthode.When the RichTextBoxFinds.Reverse value is specified in the options parameter, the value of the start parameter indicates the position where the reverse search will end since the search will start at the bottom of the document when using this version of the Find method.

Notes

Les Find méthodes qui acceptent un string comme paramètre ne peuvent pas rechercher le texte contenu dans plusieurs lignes de texte dans le RichTextBox.The Find methods that accept a string as a parameter cannot find text that is contained on more than one line of text within the RichTextBox. Une telle recherche retourne une valeur négative 1 (-1).Performing such a search will return a value of negative one (-1).

Find(Char[], Int32, Int32) Find(Char[], Int32, Int32) Find(Char[], Int32, Int32) 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.Searches a range of text in a RichTextBox control for the first instance of a character from a list of characters.

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.The array of characters to search for.

start
Int32 Int32 Int32 Int32

Position à laquelle débute la recherche dans le texte du contrôle.The location within the control's text at which to begin searching.

end
Int32 Int32 Int32 Int32

Position à laquelle se termine la recherche dans le texte du contrôle.The location within the control's text at which to end searching.

Retours

Emplacement du contrôle où les caractères recherchés ont été trouvés.The location within the control where the search characters are found.

Exceptions

characterSet a la valeur null.characterSet is null.

start est inférieur à 0 ou supérieur à la longueur du texte dans le contrôle.start is less than 0 or greater than the length of the text in the control.

Remarques

Cette version de la Find méthode recherche la première instance d’un caractère dans une liste de caractères spécifiée dans le characterSet paramètre et retourne l’emplacement du caractère.This version of the Find method searches for the first instance of a character from a list of characters specified in the characterSet parameter and returns the location of the character. Par exemple, vous transmettez un tableau de caractères contenant le caractère « Q ».For example, you pass an array of characters containing the character 'Q'. Si le contrôle contenait le texte « The Quick Brown Fox », Find la méthode retournerait la valeur de quatre.If the control contained the text "The Quick Brown Fox", the Find method would return the value of four. Un caractère majuscule et un caractère minuscule sont considérés comme des valeurs différentes dans la recherche.An upper case character and a lower case character are considered different values in the search.

Si la propriété retourne une valeur négative, les caractères recherchés sont introuvables dans le contenu du contrôle.If the property returns a negative value, the characters being searched for were not found within the contents of the control. Vous pouvez utiliser cette méthode pour rechercher un groupe de caractères dans le contrôle.You can use this method to search for a group of characters within the control. Si un caractère de la liste de caractères fourni dans le paramètre characterSet de 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.If a character from the character list provided in the method's characterSet parameter is found, the value returned by this method is a zero based index of the character's position in the control. 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.A space is considered a character by the method when determining the location of a character.

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 start valeur end pour les paramètres et.This version of the Find method enables you to search for a character set from a range of text in the control by specifying a value for the start and end parameters. La valeur zéro pour le start paramètre indique que la recherche doit commencer à partir du début du document du contrôle.A value of zero for the start parameter indicates that the search should start from the beginning of the control's document. Une valeur-1 pour le end paramètre indique que la recherche doit se terminer à la fin du texte dans le contrôle.A -1 value for the end parameter indicates that the search should end at the end of the text within the control. Vous pouvez utiliser cette version de la Find méthode pour limiter votre recherche à une plage de texte spécifique dans le contrôle afin d’éviter de rechercher des zones du document qui ne sont pas importantes pour les besoins de votre application.You can use this version of the Find method to narrow your search to a specific range of text within the control to avoid searching areas of the document that are not important to the needs of your application.

Find(Char[]) Find(Char[]) Find(Char[]) Find(Char[])

Recherche dans le texte d'un contrôle RichTextBox la première occurrence d'un caractère issu d'une liste.Searches the text of a RichTextBox control for the first instance of a character from a list of characters.

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.The array of characters to search for.

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.The location within the control where the search characters were found or -1 if the search characters are not found or an empty search character set is specified in the char parameter.

Exemples

L’exemple de code suivant recherche le contenu d' RichTextBox un pour les caractères passés à la méthode dans le text paramètre.The following code example searches the contents of a RichTextBox for the characters that are passed to the method in the text parameter. Si le contenu du text tableau est trouvé dans le RichTextBox, la méthode retourne l’index de la valeur trouvée ; sinon, elle retourne-1.If the contents of the text array are found in the RichTextBox, the method returns the index of the value that is found; otherwise, it returns -1. L’exemple requiert 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 button1nommé, qui est connecté au Click gestionnaire d’événements défini dans l’exemple.The example requires that this method is placed in the class of a Form that contains a RichTextBox control named richTextBox1 and a Button control, named button1, that is connected to the Click event handler defined in the example.

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 dans une liste de caractères spécifiée dans le characterSet paramètre et retourne l’emplacement du caractère.This version of the Find method searches for the first instance of a character from a list of characters specified in the characterSet parameter and returns the location of the character. Par exemple, vous transmettez un tableau de caractères contenant le caractère « Q ».For example, you pass an array of characters containing the character 'Q'. Si le contrôle contenait le texte « The Quick Brown Fox », Find la méthode retournerait la valeur de quatre.If the control contained the text "The Quick Brown Fox", the Find method would return the value of four. Un caractère majuscule et un caractère minuscule sont considérés comme des valeurs différentes dans la recherche.An upper case character and a lower case character are considered different values in the search.

Si la propriété retourne une valeur négative, les caractères recherchés sont introuvables dans le contenu du contrôle.If the property returns a negative value, the characters being searched for were not found within the contents of the control. Vous pouvez utiliser cette méthode pour rechercher un groupe de caractères dans le contrôle.You can use this method to search for a group of characters within the control. Cette version de la Find méthode requiert que les caractères soient recherchés dans l’intégralité du document contenu dans le contrôle.This version of the Find method requires that the entire document contained in the control is searched for the characters. Si un caractère de la liste de caractères fourni dans le paramètre characterSet de 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.If a character from the character list provided in the method's characterSet parameter is found, the value returned by this method is a zero-based index of the character's position in the control. 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.A space is considered a character by the method when determining the location of a character.

Find(Char[], Int32) Find(Char[], Int32) Find(Char[], Int32) 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.Searches the text of a RichTextBox control, at a specific starting point, for the first instance of a character from a list of characters.

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.The array of characters to search for.

start
Int32 Int32 Int32 Int32

Position à laquelle débute la recherche dans le texte du contrôle.The location within the control's text at which to begin searching.

Retours

Emplacement du contrôle où les caractères recherchés ont été trouvés.The location within the control where the search characters are found.

Exemples

L’exemple de code suivant recherche le contenu d' RichTextBox un pour les caractères passés à la méthode dans le text paramètre.The following code example searches the contents of a RichTextBox for the characters that are passed to the method in the text parameter. La recherche commence à partir de l’emplacement RichTextBox dans le spécifié start par le paramètre FindMyText de la méthode.The search begins from the location within the RichTextBox specified by the start parameter of the FindMyText method. Si le contenu du tableau de texte se trouve dans RichTextBox, la méthode retourne l’index de la valeur trouvée ; sinon, elle retourne-1.If the contents of the text array are found in the RichTextBox, the method returns the index of the value that is found; otherwise, it returns -1. L’exemple requiert que cette méthode soit placée dans la classe d’un Form qui contient un RichTextBox contrôle nommé richTextBox1 et Click un Button contrôle nommé button1 qui est connecté au gestionnaire d’événements défini dans la tels.The example requires that this method is placed in the class of a Form that contains a RichTextBox control named richTextBox1 and a Button control named button1 that is connected to the Click event handler defined in the example.

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 dans une liste de caractères spécifiée dans le characterSet paramètre et retourne l’emplacement du caractère.This version of the Find method searches for the first instance of a character from a list of characters specified in the characterSet parameter and returns the location the character. Par exemple, vous transmettez un tableau de caractères contenant le caractère « Q ».For example, you pass an array of characters containing the character 'Q'. Si le contrôle contenait le texte « The Quick Brown Fox », Find la méthode retournerait la valeur de quatre.If the control contained the text "The Quick Brown Fox", the Find method would return the value of four. Un caractère majuscule et un caractère minuscule sont considérés comme des valeurs différentes dans la recherche.An upper case character and a lower case character are considered different values in the search.

Si la propriété retourne une valeur négative, les caractères recherchés sont introuvables dans le contenu du contrôle.If the property returns a negative value, the characters being searched for were not found within the contents of the control. Vous pouvez utiliser cette méthode pour rechercher un groupe de caractères dans le contrôle.You can use this method to search for a group of characters within the control. Si un caractère de la liste de caractères fourni dans le paramètre characterSet de 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.If a character from the character list provided in the method's characterSet parameter is found, the value returned by this method is a zero-based index of the character's position in the control. 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.A space is considered a character by the method when determining the location of a character.

Cette version de la Find méthode vous permet de rechercher un jeu de caractères à partir d’une position de départ spécifiée dans le texte du contrôle en spécifiant une start valeur pour le paramètre.This version of the Find method enables you to search for a character set from a specified start position within the text of the control by specifying a value for the start parameter. La valeur zéro indique que la recherche doit commencer à partir du début du document du contrôle.A value of zero indicates that the search should start from the beginning of the control's document. Vous pouvez utiliser cette version de la Find méthode pour affiner votre recherche afin d’éviter que du texte que vous connaissez déjà ne contienne les caractères spécifiés que vous recherchez ou qu’il ne soit pas important dans votre recherche.You can use this version of the Find method to narrow your search to avoid text that you already know does not contain the specified characters you are searching for or are not important in your search.

Find(String) Find(String) Find(String) Find(String)

Recherche une chaîne donnée dans le texte d'un contrôle RichTextBox.Searches the text in a RichTextBox control for a string.

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 String String String

Texte recherché dans le contrôle.The text to locate in the control.

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.The location within the control where the search text was found or -1 if the search string is not found or an empty search string is specified in the str parameter.

Exemples

L’exemple de code suivant recherche dans l’ensemble du RichTextBox contenu d’un pour la première instance d’une chaîne de recherche passée dans le paramètre text de la méthode.The following code example searches the entire contents of a RichTextBox for the first instance of a search string passed into the text parameter of the method. Si la chaîne recherchée est trouvée RichTextBoxdans le, la méthode retourne une true valeur et met en surbrillance le texte falserecherché, sinon il retourne.If the search string is found in the RichTextBox, the method returns a value of true and highlights the search text, otherwise it returns false. L’exemple requiert que cette méthode soit placée dans la classe d’un Form qui contient un RichTextBox nommé richTextBox1.The example requires that this method is placed in the class of a Form that contains a RichTextBox named 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.The Find method searches for the text specified in the str parameter and returns the location of the first character within the control. Si la propriété retourne une valeur négative, la chaîne de texte recherchée est introuvable dans le contenu du contrôle.If the property returns a negative value, the text string being searched for was not found within the contents of the control. Vous pouvez utiliser cette méthode pour créer des fonctionnalités de recherche qui peuvent être fournies à l’utilisateur du contrôle.You can use this method to create search functionality that can be provided to the user of the control. Vous pouvez également utiliser cette méthode pour rechercher du texte à remplacer par un format spécifique.You can also use this method to search for text to be replaced with a specific format. Par exemple, si l’utilisateur a entré des dates dans le contrôle, vous pouvez Find utiliser la méthode pour rechercher toutes les dates dans le document et les remplacer par le format approprié avant SaveFile d’utiliser la méthode du contrôle.For example, if the user entered dates into the control, you could use the Find method to search for all dates in the document and replace them with the appropriate format before using the SaveFile method of the control.

Notes

Les Find méthodes qui acceptent un string comme paramètre ne peuvent pas rechercher le texte contenu dans plusieurs lignes de texte dans le RichTextBox.The Find methods that accept a string as a parameter cannot find text that is contained on more than one line of text within the RichTextBox. Une telle recherche retourne une valeur négative 1 (-1).Performing such a search will return a value of negative one (-1).

Find(String, RichTextBoxFinds) Find(String, RichTextBoxFinds) Find(String, RichTextBoxFinds) Find(String, RichTextBoxFinds)

Recherche une chaîne dans le texte d'un contrôle RichTextBox en appliquant des options de recherche spécifiques.Searches the text in a RichTextBox control for a string with specific options applied to the search.

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 String String String

Texte recherché dans le contrôle.The text to locate in the control.

options
RichTextBoxFinds RichTextBoxFinds RichTextBoxFinds RichTextBoxFinds

Combinaison d'opérations de bits des valeurs RichTextBoxFinds.A bitwise combination of the RichTextBoxFinds values.

Retours

Emplacement du contrôle où le texte recherché a été trouvé.The location within the control where the search text was found.

Exemples

L’exemple de code suivant recherche dans l’ensemble du RichTextBox contenu d’un pour la première instance d’une chaîne de recherche passée dans le paramètre text de la méthode.The following code example searches the entire contents of a RichTextBox for the first instance of a search string passed into the text parameter of the method. Si la chaîne recherchée est trouvée RichTextBoxdans le, la méthode retourne une true valeur et met le texte en surbrillance false; sinon, elle retourne.If the search string is found in the RichTextBox, the method returns a value of true and highlights the text; otherwise, it returns false. L’exemple spécifie également les options de recherche qui correspondent à la casse de la chaîne de recherche spécifiée.The example also specifies options in the search to match the case of the specified search string. L’exemple requiert que cette méthode soit placée dans la classe d’un Form qui contient un RichTextBox nommé richTextBox1.The example requires that this method is placed in the class of a Form that contains a RichTextBox named 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.The Find method searches for the text specified in the str parameter and returns the location of the first character within the control. Si la propriété retourne une valeur négative, la chaîne de texte recherchée est introuvable dans le contenu du contrôle.If the property returns a negative value, the text string being searched for was not found within the contents of the control. Vous pouvez utiliser cette méthode pour créer des fonctionnalités de recherche qui peuvent être fournies à l’utilisateur du contrôle.You can use this method to create search functionality that can be provided to the user of the control. Vous pouvez également utiliser cette méthode pour rechercher du texte à remplacer par un format spécifique.You can also use this method to search for text to be replaced with a specific format. Par exemple, si l’utilisateur a entré des dates dans le contrôle, vous pouvez Find utiliser la méthode pour rechercher toutes les dates dans le document et les remplacer par le format approprié avant SaveFile d’utiliser la méthode du contrôle.For example, if the user entered dates into the control, you can use the Find method to search for all dates in the document and replace them with the appropriate format before using the SaveFile method of the control.

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.With this version of the Find method, you can specify options that enable you to expand or narrow your search. Vous pouvez spécifier des options qui vous permettent de mettre en correspondance la casse du mot recherché ou de rechercher des mots entiers plutôt que des mots partiels.You can specify options that enable you to match the casing of the search word or to search for entire words instead of partial words. En spécifiant RichTextBoxFinds.Reverse l’énumération options dans le paramètre, vous pouvez rechercher du texte à partir du bas du document vers le haut au lieu de la méthode de recherche de haut en bas par défaut.By specifying the RichTextBoxFinds.Reverse enumeration in the options parameter, you can search for text from the bottom of the document to the top instead of the default top to bottom search method.

Notes

Les Find méthodes qui acceptent un string comme paramètre ne peuvent pas rechercher le texte contenu dans plusieurs lignes de texte dans le RichTextBox.The Find methods that accept a string as a parameter cannot find text that is contained on more than one line of text within the RichTextBox. Une telle recherche retourne une valeur négative 1 (-1).Performing such a search will return a value of negative one (-1).

S’applique à