RichTextBox.Find Methode

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

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

Parameters

Retouren

De locatie in het besturingselement waar de zoektekens zijn gevonden of -1 als de zoektekens niet worden gevonden of als er een lege zoektekenset is opgegeven in de char parameter.

Voorbeelden

In het volgende codevoorbeeld wordt gezocht naar de inhoud van een RichTextBox voor de tekens die worden doorgegeven aan de methode in de text parameter. Als de inhoud van de matrix in de textRichTextBoxmatrix wordt gevonden, retourneert de methode de index van de gevonden waarde. Anders wordt -1 geretourneerd. Voor het voorbeeld moet deze methode worden geplaatst in de klasse van een Form besturingselement met een RichTextBox naam richTextBox1 en een besturingselement met de naam van een Button besturingselement button1dat is verbonden met de Click gebeurtenis-handler die in het voorbeeld is gedefinieerd.

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

Opmerkingen

Deze versie van de Find methode zoekt naar het eerste exemplaar van een teken uit een lijst met tekens die zijn opgegeven in de characterSet parameter en retourneert de locatie van het teken. U geeft bijvoorbeeld een matrix met tekens door die het teken Q bevatten. Als het besturingselement de tekst 'The Quick Brown Fox' bevat, retourneert de Find methode de waarde van vier. Een hoofdletter en een kleine letter worden beschouwd als verschillende waarden in de zoekopdracht.

Als de eigenschap een negatieve waarde retourneert, zijn de tekens die worden gezocht, niet gevonden in de inhoud van het besturingselement. U kunt deze methode gebruiken om te zoeken naar een groep tekens in het besturingselement. Voor deze versie van de Find methode is vereist dat het hele document in het besturingselement naar de tekens wordt gezocht. Als een teken uit de lijst met tekens in de parameter van characterSet de methode wordt gevonden, is de waarde die door deze methode wordt geretourneerd, een op nul gebaseerde index van de positie van het teken in het besturingselement. Een spatie wordt door de methode beschouwd als een teken bij het bepalen van de locatie van een teken.

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

public:
 int Find(System::String ^ str);

public int Find(string str);

member this.Find : string -> int

Public Function Find (str As String) As Integer

Parameters

Retouren

De locatie in het besturingselement waar de zoektekst is gevonden of -1 als de zoekreeks niet wordt gevonden of als er een lege zoekreeks is opgegeven in de str parameter.

Voorbeelden

In het volgende codevoorbeeld wordt gezocht naar de volledige inhoud van een RichTextBox voor het eerste exemplaar van een zoekreeks die is doorgegeven aan de tekstparameter van de methode. Als de zoektekenreeks in de RichTextBoxtekenreeks wordt gevonden, retourneert de methode een waarde van true en markeert de zoektekst, anders wordt deze geretourneerd false. Voor het voorbeeld is vereist dat deze methode wordt geplaatst in de klasse van een Form klasse die een RichTextBox benoemde bevat 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

Opmerkingen

De Find methode zoekt naar de tekst die is opgegeven in de str parameter en retourneert de locatie van het eerste teken in het besturingselement. Als de eigenschap een negatieve waarde retourneert, is de tekenreeks die wordt gezocht, niet gevonden in de inhoud van het besturingselement. U kunt deze methode gebruiken om zoekfunctionaliteit te maken die kan worden verstrekt aan de gebruiker van het besturingselement. U kunt deze methode ook gebruiken om te zoeken naar tekst die moet worden vervangen door een specifieke indeling. Als de gebruiker bijvoorbeeld datums in het besturingselement heeft ingevoerd, kunt u de Find methode gebruiken om te zoeken naar alle datums in het document en deze te vervangen door de juiste indeling voordat u de SaveFile methode van het besturingselement gebruikt.

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

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

Parameters

Retouren

De locatie in het besturingselement waar de zoektekens worden gevonden.

Voorbeelden

In het volgende codevoorbeeld wordt gezocht naar de inhoud van een RichTextBox voor de tekens die worden doorgegeven aan de methode in de text parameter. De zoekopdracht begint vanaf de locatie binnen de RichTextBox opgegeven door de start parameter van de FindMyText methode. Als de inhoud van de tekstmatrix in de RichTextBoxmatrix wordt gevonden, retourneert de methode de index van de gevonden waarde. Anders wordt -1 geretourneerd. Voor het voorbeeld is vereist dat deze methode wordt geplaatst in de klasse van een Form besturingselement met een RichTextBox benoemd besturingselement richTextBox1 en een besturingselement met de Button naam button1 die is verbonden met de Click gebeurtenis-handler die in het voorbeeld is gedefinieerd.

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

Opmerkingen

Deze versie van de Find methode zoekt naar het eerste exemplaar van een teken uit een lijst met tekens die zijn opgegeven in de characterSet parameter en retourneert de locatie van het teken. U geeft bijvoorbeeld een matrix met tekens door die het teken Q bevatten. Als het besturingselement de tekst 'The Quick Brown Fox' bevat, retourneert de Find methode de waarde van vier. Een hoofdletter en een kleine letter worden beschouwd als verschillende waarden in de zoekopdracht.

Als de eigenschap een negatieve waarde retourneert, zijn de tekens die worden gezocht, niet gevonden in de inhoud van het besturingselement. U kunt deze methode gebruiken om te zoeken naar een groep tekens in het besturingselement. Als een teken uit de lijst met tekens in de parameter van characterSet de methode wordt gevonden, is de waarde die door deze methode wordt geretourneerd, een op nul gebaseerde index van de positie van het teken in het besturingselement. Een spatie wordt door de methode beschouwd als een teken bij het bepalen van de locatie van een teken.

Met deze versie van de Find methode kunt u zoeken naar een tekenset vanaf een opgegeven beginpositie in de tekst van het besturingselement door een waarde voor de start parameter op te geven. Een waarde van nul geeft aan dat de zoekopdracht moet beginnen vanaf het begin van het document van het besturingselement. U kunt deze versie van de Find methode gebruiken om uw zoekopdracht te beperken om te voorkomen dat tekst die u al kent niet de opgegeven tekens bevat die u zoekt of die niet belangrijk zijn in uw zoekopdracht.

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

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

Parameters

Retouren

De locatie in het besturingselement waar de zoektekst is gevonden.

Voorbeelden

In het volgende codevoorbeeld wordt gezocht naar de volledige inhoud van een RichTextBox voor het eerste exemplaar van een zoekreeks die is doorgegeven aan de tekstparameter van de methode. Als de zoekreeks in de RichTextBoxtekenreeks wordt gevonden, retourneert de methode een waarde van true en markeert de tekst; anders wordt de tekst geretourneerd false. In het voorbeeld worden ook opties in de zoekopdracht opgegeven die overeenkomen met het hoofdlettergebruik van de opgegeven zoekreeks. Voor het voorbeeld is vereist dat deze methode wordt geplaatst in de klasse van een Form klasse die een RichTextBox benoemde bevat 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

Opmerkingen

De Find methode zoekt naar de tekst die is opgegeven in de str parameter en retourneert de locatie van het eerste teken in het besturingselement. Als de eigenschap een negatieve waarde retourneert, is de tekenreeks die wordt gezocht, niet gevonden in de inhoud van het besturingselement. U kunt deze methode gebruiken om zoekfunctionaliteit te maken die kan worden verstrekt aan de gebruiker van het besturingselement. U kunt deze methode ook gebruiken om te zoeken naar tekst die moet worden vervangen door een specifieke indeling. Als de gebruiker bijvoorbeeld datums in het besturingselement heeft ingevoerd, kunt u de Find methode gebruiken om te zoeken naar alle datums in het document en deze te vervangen door de juiste indeling voordat u de SaveFile methode van het besturingselement gebruikt.

Met deze versie van de Find methode kunt u opties opgeven waarmee u uw zoekopdracht kunt uitbreiden of verfijnen. U kunt opties opgeven waarmee u het hoofdlettergebruik van het zoekwoord kunt vergelijken of kunt zoeken naar hele woorden in plaats van gedeeltelijke woorden. Door de RichTextBoxFinds.Reverse opsomming in de options parameter op te geven, kunt u vanaf de onderkant van het document naar boven zoeken in plaats van de standaardzoekmethode boven naar beneden.

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

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

Parameters

Retouren

De locatie in het besturingselement waar de zoektekens worden gevonden.

Uitzonderingen

Opmerkingen

Deze versie van de Find methode zoekt naar het eerste exemplaar van een teken uit een lijst met tekens die zijn opgegeven in de characterSet parameter en retourneert de locatie van het teken. U geeft bijvoorbeeld een matrix met tekens door die het teken Q bevatten. Als het besturingselement de tekst 'The Quick Brown Fox' bevat, retourneert de Find methode de waarde van vier. Een hoofdletter en een kleine letter worden beschouwd als verschillende waarden in de zoekopdracht.

Als de eigenschap een negatieve waarde retourneert, zijn de tekens die worden gezocht, niet gevonden in de inhoud van het besturingselement. U kunt deze methode gebruiken om te zoeken naar een groep tekens in het besturingselement. Als een teken uit de lijst met tekens in de parameter van characterSet de methode wordt gevonden, is de waarde die door deze methode wordt geretourneerd, een op nul gebaseerde index van de positie van het teken in het besturingselement. Een spatie wordt door de methode beschouwd als een teken bij het bepalen van de locatie van een teken.

Met deze versie van de Find methode kunt u zoeken naar een tekenset uit een tekstbereik in het besturingselement door een waarde voor de start en end parameters op te geven. Een waarde van nul voor de start parameter geeft aan dat de zoekopdracht moet beginnen vanaf het begin van het document van het besturingselement. Een -1-waarde voor de end parameter geeft aan dat de zoekopdracht moet eindigen aan het einde van de tekst in het besturingselement. U kunt deze versie van de Find methode gebruiken om uw zoekopdracht te beperken tot een specifiek tekstbereik binnen het besturingselement om te voorkomen dat zoekgebieden van het document die niet belangrijk zijn voor de behoeften van uw toepassing.

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

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

Parameters

Retouren

De locatie in het besturingselement waar de zoektekst is gevonden.

Voorbeelden

In het volgende codevoorbeeld wordt gezocht naar de volledige inhoud van een RichTextBox voor het eerste exemplaar van een zoekreeks die is doorgegeven aan de tekstparameter van de methode. De zoeklocatie wordt opgegeven door de beginparameter van de methode. Als de zoektekenreeks in de RichTextBoxtekenreeks wordt gevonden, retourneert de methode de indexlocatie van het eerste teken van de gevonden tekst en wordt de gevonden tekst gemarkeerd. Anders wordt een waarde van -1 geretourneerd. In het voorbeeld worden ook opties in de zoekopdracht opgegeven die overeenkomen met het hoofdlettergebruik van de opgegeven zoekreeks. Voor het voorbeeld is vereist dat deze methode wordt geplaatst in de klasse van een Form klasse die een RichTextBox benoemde bevat richTextBox1. U kunt dit voorbeeld gebruiken om het type 'Volgende zoeken' uit te voeren. Zodra een exemplaar van de zoektekst is gevonden, kunt u andere exemplaren van de tekst vinden door de waarde van de start parameter te wijzigen om te zoeken op een locatie buiten de positie van de huidige overeenkomst.

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

Opmerkingen

De Find methode zoekt naar de tekst die is opgegeven in de str parameter en retourneert de locatie van het eerste teken van de zoekreeks in het besturingselement. Als de eigenschap een negatieve waarde retourneert, is de tekenreeks die wordt gezocht, niet gevonden in de inhoud van het besturingselement. U kunt deze methode gebruiken om zoekfunctionaliteit te maken die kan worden verstrekt aan de gebruiker van het besturingselement. U kunt deze methode ook gebruiken om te zoeken naar tekst die moet worden vervangen door een specifieke indeling. Als de gebruiker bijvoorbeeld datums in het besturingselement heeft ingevoerd, kunt u de Find methode gebruiken om te zoeken naar alle datums in het document en deze te vervangen door de juiste indeling voordat u de SaveFile methode van het besturingselement gebruikt.

Met deze versie van de Find methode kunt u opties opgeven waarmee u uw zoekopdracht kunt uitbreiden of verfijnen. U kunt opties opgeven waarmee u het hoofdlettergebruik van het zoekwoord kunt vergelijken of kunt zoeken naar hele woorden in plaats van gedeeltelijke woorden. Door de RichTextBoxFinds.Reverse opsomming in de options parameter op te geven, kunt u vanaf de onderkant van het document naar boven zoeken in plaats van de standaardzoekmethode boven naar beneden. Met deze versie van de Find methode kunt u ook de zoekfunctie voor tekst beperken door een specifieke beginpositie in de tekst van het besturingselement te selecteren. Met deze functie kunt u voorkomen dat tekst die al is doorzocht of waar de specifieke tekst waarnaar u zoekt, niet bestaat. Wanneer de RichTextBoxFinds.Reverse waarde is opgegeven in de options parameter, geeft de waarde van de start parameter de positie aan waar de omgekeerde zoekopdracht eindigt, omdat de zoekopdracht onderaan het document begint wanneer deze versie van de Find methode wordt gebruikt.

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

Bron:

RichTextBox.cs

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

Parameters

Retouren

De locatie in het besturingselement waar de zoektekst is gevonden.

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld wordt gezocht in een tekstsectie in een RichTextBox voor het eerste exemplaar van een zoekreeks die is doorgegeven aan de searchText parameter van de methode. Het bereik voor het zoeken naar tekst in het besturingselement wordt opgegeven door de searchStart en searchEnd parameters van de methode. Als de zoektekenreeks in de RichTextBoxtekenreeks wordt gevonden, retourneert de methode de indexlocatie van het eerste teken van de gevonden tekst en wordt de gevonden tekst gemarkeerd. Anders wordt een waarde van -1 geretourneerd. In het voorbeeld wordt ook de options parameter van de Find methode gebruikt om op te geven dat de gevonden tekst overeenkomt met het hoofdlettergebruik van de zoekreeks. Voor het voorbeeld is vereist dat deze methode wordt geplaatst in de klasse van een Form besturingselement met de RichTextBox naam richTextBox1. Nadat het eerste exemplaar van de zoekreeks is gevonden, kunt u dit voorbeeld gebruiken om andere exemplaren in de tekst te vinden.

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

Opmerkingen

De Find methode zoekt naar de tekst die is opgegeven in de str parameter en retourneert de locatie van het eerste teken van de zoekreeks in het besturingselement. Als de eigenschap een negatieve waarde retourneert, is de tekenreeks die wordt gezocht, niet gevonden in de inhoud van het besturingselement. U kunt deze methode gebruiken om zoekfunctionaliteit te maken die kan worden verstrekt aan de gebruiker van het besturingselement. U kunt deze methode ook gebruiken om te zoeken naar tekst die moet worden vervangen door een specifieke indeling. Als de gebruiker bijvoorbeeld datums in het besturingselement heeft ingevoerd, kunt u de Find methode gebruiken om te zoeken naar alle datums in het document en deze te vervangen door de juiste indeling voordat u de SaveFile methode van het besturingselement gebruikt.

Met deze versie van de Find methode kunt u opties opgeven waarmee u uw zoekopdracht kunt uitbreiden of verfijnen. U kunt opties opgeven waarmee u het hoofdlettergebruik van het zoekwoord kunt vergelijken of kunt zoeken naar hele woorden in plaats van gedeeltelijke woorden. Door de RichTextBoxFinds.Reverse opsomming in de options parameter op te geven, kunt u vanaf de onderkant van het document naar boven zoeken in plaats van de standaardzoekmethode boven naar beneden. Met deze versie van de Find methode kunt u ook de zoekfunctie voor tekst beperken door een specifieke begin- en eindpositie in de tekst van het besturingselement te selecteren. Met deze functie kunt u het zoekbereik beperken tot een specifieke sectie van de tekst van het besturingselement. Als een waarde van een negatieve waarde (-1) is toegewezen aan de end parameter, zoekt de methode tot het einde van de tekst in de RichTextBox normale zoekopdrachten. Voor omgekeerde zoekopdrachten geeft een waarde van een negatieve waarde (-1) die is toegewezen aan de parameter aan dat tekst wordt doorzocht vanaf het einde van de tekst (onder) naar de positie die is gedefinieerd door end de start parameter. Wanneer de start en end parameters dezelfde waarde opgeven, wordt in het hele besturingselement gezocht naar normale zoekopdrachten. Voor een omgekeerde zoekopdracht wordt het hele besturingselement doorzocht, maar de zoekopdracht begint onder aan het document en zoekt naar het begin van het document.