RichTextBox.Find Methode

Quelle:

RichTextBox.cs

Quelle:

RichTextBox.cs

Quelle:

RichTextBox.cs

Quelle:

RichTextBox.cs

Quelle:

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

Parameter

Gibt zurück

Die Position innerhalb des Steuerelements, an dem die Suchzeichen gefunden wurden oder -1, wenn die Suchzeichen nicht gefunden werden oder ein leerer Suchzeichensatz im char Parameter angegeben wird.

Beispiele

Im folgenden Codebeispiel wird der Inhalt einer RichTextBox nach den Zeichen durchsucht, die an die Methode im text Parameter übergeben werden. Wenn der Inhalt des text Arrays in der RichTextBoxGefundenen gefunden wird, gibt die Methode den Index des gefundenen Werts zurück. Andernfalls wird -1 zurückgegeben. Das Beispiel erfordert, dass diese Methode in der Klasse eines Form Steuerelements platziert wird, das ein RichTextBox Steuerelement mit dem Namen richTextBox1 und einem Button Steuerelement mit dem button1im Beispiel definierten Ereignishandler enthält Click .

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

Hinweise

Diese Version der Find Methode sucht nach der ersten Instanz eines Zeichens aus einer Liste von Zeichen, die characterSet im Parameter angegeben sind, und gibt die Position des Zeichens zurück. Sie übergeben beispielsweise ein Array von Zeichen, das das Zeichen "Q" enthält. Wenn das Steuerelement den Text "The Quick Brown Fox" enthielt, würde die Find Methode den Wert von vier zurückgeben. Ein Groß-/Kleinschreibungszeichen und ein Kleinbuchstabe werden in der Suche als unterschiedliche Werte betrachtet.

Wenn die Eigenschaft einen negativen Wert zurückgibt, wurden die gesuchten Zeichen nicht innerhalb des Inhalts des Steuerelements gefunden. Mit dieser Methode können Sie nach einer Gruppe von Zeichen innerhalb des Steuerelements suchen. Diese Version der Find Methode erfordert, dass das gesamte Dokument im Steuerelement nach den Zeichen durchsucht wird. Wenn ein Zeichen aus der im Parameter der Methode characterSet angegebenen Zeichenliste gefunden wird, ist der von dieser Methode zurückgegebene Wert ein nullbasierter Index der Position des Zeichens im Steuerelement. Ein Leerzeichen wird von der Methode beim Bestimmen der Position eines Zeichens als Zeichen betrachtet.

Quelle:

RichTextBox.cs

Quelle:

RichTextBox.cs

Quelle:

RichTextBox.cs

Quelle:

RichTextBox.cs

Quelle:

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

Parameter

Gibt zurück

Die Position innerhalb des Steuerelements, an dem der Suchtext gefunden wurde, oder -1, wenn die Suchzeichenfolge nicht gefunden wird oder eine leere Suchzeichenfolge im str Parameter angegeben wird.

Beispiele

Im folgenden Codebeispiel wird der gesamte Inhalt einer RichTextBox Suchzeichenfolge durchsucht, die an den Textparameter der Methode übergeben wird. Wenn die Suchzeichenfolge in der RichTextBoxZeichenfolge gefunden wird, gibt die Methode einen Wert zurück true und hebt den Suchtext hervor, andernfalls wird er zurückgegeben false. Das Beispiel erfordert, dass diese Methode in der Klasse einer Form Klasse platziert wird, die einen RichTextBox benannten Namen richTextBox1enthält.

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

Hinweise

Die Find Methode sucht nach dem im str Parameter angegebenen Text und gibt die Position des ersten Zeichens innerhalb des Steuerelements zurück. Wenn die Eigenschaft einen negativen Wert zurückgibt, wurde die gesuchte Textzeichenfolge im Inhalt des Steuerelements nicht gefunden. Mit dieser Methode können Sie Suchfunktionen erstellen, die dem Benutzer des Steuerelements zur Verfügung gestellt werden können. Sie können diese Methode auch verwenden, um nach Text zu suchen, der durch ein bestimmtes Format ersetzt werden soll. Wenn der Benutzer beispielsweise Datumsangaben in das Steuerelement eingegeben hat, können Sie mit der Find Methode nach allen Datumsangaben im Dokument suchen und diese durch das entsprechende Format ersetzen, bevor Sie die SaveFile Methode des Steuerelements verwenden.

Quelle:

RichTextBox.cs

Quelle:

RichTextBox.cs

Quelle:

RichTextBox.cs

Quelle:

RichTextBox.cs

Quelle:

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

Parameter

Gibt zurück

Die Position innerhalb des Steuerelements, an dem die Suchzeichen gefunden werden.

Beispiele

Im folgenden Codebeispiel wird der Inhalt einer RichTextBox nach den Zeichen durchsucht, die an die Methode im text Parameter übergeben werden. Die Suche beginnt mit der Position innerhalb des RichTextBox angegebenen start Parameters der FindMyText Methode. Wenn der Inhalt des Textarrays in der RichTextBoxZeichenfolge gefunden wird, gibt die Methode den Index des gefundenen Werts zurück. Andernfalls wird -1 zurückgegeben. Das Beispiel erfordert, dass diese Methode in die Klasse eines Form Steuerelements eingefügt wird, das ein RichTextBox Steuerelement mit dem Namen richTextBox1 und einem Button Steuerelement enthält button1 , das mit dem Click im Beispiel definierten Ereignishandler verbunden ist.

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

Hinweise

Diese Version der Find Methode sucht nach der ersten Instanz eines Zeichens aus einer Liste von Zeichen, die characterSet im Parameter angegeben sind, und gibt die Position des Zeichens zurück. Sie übergeben beispielsweise ein Array von Zeichen, das das Zeichen "Q" enthält. Wenn das Steuerelement den Text "The Quick Brown Fox" enthielt, würde die Find Methode den Wert von vier zurückgeben. Ein Groß-/Kleinschreibungszeichen und ein Kleinbuchstabe werden in der Suche als unterschiedliche Werte betrachtet.

Wenn die Eigenschaft einen negativen Wert zurückgibt, wurden die gesuchten Zeichen nicht innerhalb des Inhalts des Steuerelements gefunden. Mit dieser Methode können Sie nach einer Gruppe von Zeichen innerhalb des Steuerelements suchen. Wenn ein Zeichen aus der im Parameter der Methode characterSet angegebenen Zeichenliste gefunden wird, ist der von dieser Methode zurückgegebene Wert ein nullbasierter Index der Position des Zeichens im Steuerelement. Ein Leerzeichen wird von der Methode beim Bestimmen der Position eines Zeichens als Zeichen betrachtet.

Mit dieser Version der Find Methode können Sie nach einem Zeichensatz aus einer angegebenen Startposition innerhalb des Texts des Steuerelements suchen, indem Sie einen Wert für den start Parameter angeben. Ein Wert von Null gibt an, dass die Suche vom Anfang des Steuerelementdokuments beginnen soll. Sie können diese Version der Find Methode verwenden, um die Suche einzuschränken, um Text zu vermeiden, den Sie bereits kennen, enthält nicht die angegebenen Zeichen, nach denen Sie suchen, oder sind in Der Suche nicht wichtig.

Quelle:

RichTextBox.cs

Quelle:

RichTextBox.cs

Quelle:

RichTextBox.cs

Quelle:

RichTextBox.cs

Quelle:

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

Parameter

Gibt zurück

Die Position innerhalb des Steuerelements, an der der Suchtext gefunden wurde.

Beispiele

Im folgenden Codebeispiel wird der gesamte Inhalt einer RichTextBox Suchzeichenfolge durchsucht, die an den Textparameter der Methode übergeben wird. Wenn die Suchzeichenfolge in der RichTextBoxZeichenfolge gefunden wird, gibt die Methode einen Wert zurück true und hebt den Text hervor; andernfalls wird sie zurückgegeben false. Im Beispiel werden auch Optionen in der Suche angegeben, die dem Fall der angegebenen Suchzeichenfolge entsprechen sollen. Das Beispiel erfordert, dass diese Methode in der Klasse einer Form Klasse platziert wird, die einen RichTextBox benannten Namen richTextBox1enthält.

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

Hinweise

Die Find Methode sucht nach dem im str Parameter angegebenen Text und gibt die Position des ersten Zeichens innerhalb des Steuerelements zurück. Wenn die Eigenschaft einen negativen Wert zurückgibt, wurde die gesuchte Textzeichenfolge im Inhalt des Steuerelements nicht gefunden. Mit dieser Methode können Sie Suchfunktionen erstellen, die dem Benutzer des Steuerelements zur Verfügung gestellt werden können. Sie können diese Methode auch verwenden, um nach Text zu suchen, der durch ein bestimmtes Format ersetzt werden soll. Wenn der Benutzer beispielsweise Datumsangaben in das Steuerelement eingegeben hat, können Sie mit der Find Methode nach allen Datumsangaben im Dokument suchen und diese durch das entsprechende Format ersetzen, bevor Sie die SaveFile Methode des Steuerelements verwenden.

Mit dieser Version der Find Methode können Sie Optionen angeben, mit denen Sie Die Suche erweitern oder einschränken können. Sie können Optionen angeben, mit denen Sie die Groß-/Kleinschreibung des Suchworts abgleichen oder nach ganzen Wörtern anstelle von Teilwörtern suchen können. Durch Angeben der RichTextBoxFinds.Reverse Aufzählung im options Parameter können Sie nach Text vom unteren Rand des Dokuments bis zum anfang statt nach der standardmäßigen top-to-bottom-Suchmethode suchen.

Quelle:

RichTextBox.cs

Quelle:

RichTextBox.cs

Quelle:

RichTextBox.cs

Quelle:

RichTextBox.cs

Quelle:

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

Parameter

Gibt zurück

Die Position innerhalb des Steuerelements, an dem die Suchzeichen gefunden werden.

Ausnahmen

Hinweise

Diese Version der Find Methode sucht nach der ersten Instanz eines Zeichens aus einer Liste von Zeichen, die characterSet im Parameter angegeben sind, und gibt die Position des Zeichens zurück. Sie übergeben beispielsweise ein Array von Zeichen, das das Zeichen "Q" enthält. Wenn das Steuerelement den Text "The Quick Brown Fox" enthielt, würde die Find Methode den Wert von vier zurückgeben. Ein Groß-/Kleinschreibungszeichen und ein Kleinbuchstabe werden in der Suche als unterschiedliche Werte betrachtet.

Wenn die Eigenschaft einen negativen Wert zurückgibt, wurden die gesuchten Zeichen nicht innerhalb des Inhalts des Steuerelements gefunden. Mit dieser Methode können Sie nach einer Gruppe von Zeichen innerhalb des Steuerelements suchen. Wenn ein Zeichen aus der Zeichenliste gefunden wird, die im Parameter der Methode characterSet angegeben ist, ist der von dieser Methode zurückgegebene Wert ein nullbasierter Index der Position des Zeichens im Steuerelement. Ein Leerzeichen wird von der Methode beim Bestimmen der Position eines Zeichens als Zeichen betrachtet.

Mit dieser Version der Find Methode können Sie anhand eines Textbereichs im Steuerelement nach einem Zeichensatz suchen, indem Sie einen Wert für die und start die end Parameter angeben. Ein Wert von Null für den start Parameter gibt an, dass die Suche vom Anfang des Steuerelementdokuments beginnen soll. Ein -1 Wert für den end Parameter gibt an, dass die Suche am Ende des Texts innerhalb des Steuerelements enden soll. Sie können diese Version der Find Methode verwenden, um die Suche auf einen bestimmten Textbereich innerhalb des Steuerelements einzugrenzen, um das Durchsuchen von Bereichen des Dokuments zu vermeiden, die für die Anforderungen Ihrer Anwendung nicht wichtig sind.

Quelle:

RichTextBox.cs

Quelle:

RichTextBox.cs

Quelle:

RichTextBox.cs

Quelle:

RichTextBox.cs

Quelle:

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

Parameter

Gibt zurück

Die Position innerhalb des Steuerelements, an der der Suchtext gefunden wurde.

Beispiele

Im folgenden Codebeispiel wird der gesamte Inhalt einer RichTextBox Suchzeichenfolge durchsucht, die an den Textparameter der Methode übergeben wird. Der Startort der Suche wird durch den Startparameter der Methode angegeben. Wenn die Suchzeichenfolge in der RichTextBoxZeichenfolge gefunden wird, gibt die Methode die Indexposition des ersten Zeichens des gefundenen Texts zurück und hebt den gefundenen Text hervor; andernfalls wird ein Wert von -1 zurückgegeben. Im Beispiel werden auch Optionen in der Suche angegeben, die dem Fall der angegebenen Suchzeichenfolge entsprechen sollen. Das Beispiel erfordert, dass diese Methode in der Klasse einer Form Klasse platziert wird, die einen RichTextBox benannten Namen richTextBox1enthält. Sie können dieses Beispiel verwenden, um einen Vorgangstyp "Weitersuchen" auszuführen. Sobald eine Instanz des Suchtexts gefunden wurde, können Sie andere Instanzen des Texts finden, indem Sie den Wert des start Parameters so ändern, dass er an einer Stelle sucht, die über die Position der aktuellen Übereinstimmung hinausgeht.

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

Hinweise

Die Find Methode sucht nach dem im str Parameter angegebenen Text und gibt die Position des ersten Zeichens der Suchzeichenfolge innerhalb des Steuerelements zurück. Wenn die Eigenschaft einen negativen Wert zurückgibt, wurde die gesuchte Textzeichenfolge im Inhalt des Steuerelements nicht gefunden. Mit dieser Methode können Sie Suchfunktionen erstellen, die dem Benutzer des Steuerelements zur Verfügung gestellt werden können. Sie können diese Methode auch verwenden, um nach Text zu suchen, der durch ein bestimmtes Format ersetzt werden soll. Wenn der Benutzer beispielsweise Datumsangaben in das Steuerelement eingegeben hat, können Sie mit der Find Methode nach allen Datumsangaben im Dokument suchen und diese durch das entsprechende Format ersetzen, bevor Sie die SaveFile Methode des Steuerelements verwenden.

Mit dieser Version der Find Methode können Sie Optionen angeben, mit denen Sie Die Suche erweitern oder einschränken können. Sie können Optionen angeben, mit denen Sie die Groß-/Kleinschreibung des Suchworts abgleichen oder nach ganzen Wörtern anstelle von Teilwörtern suchen können. Durch Angeben der RichTextBoxFinds.Reverse Aufzählung im options Parameter können Sie nach Text vom unteren Rand des Dokuments bis zum anfang statt nach der standardmäßigen top-to-bottom-Suchmethode suchen. Mit dieser Version der Find Methode können Sie die Suche nach Text auch eingrenzen, indem Sie eine bestimmte Anfangsposition im Text des Steuerelements auswählen. Mit diesem Feature können Sie Text vermeiden, der möglicherweise bereits durchsucht wurde oder der gesuchte spezifische Text nicht vorhanden ist. Wenn der RichTextBoxFinds.Reverse Wert im options Parameter angegeben wird, gibt der Wert des start Parameters die Position an, an der die Umgekehrte Suche endet, da die Suche am Ende des Dokuments beginnt, wenn diese Version der Find Methode verwendet wird.

Quelle:

RichTextBox.cs

Quelle:

RichTextBox.cs

Quelle:

RichTextBox.cs

Quelle:

RichTextBox.cs

Quelle:

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

Parameter

Gibt zurück

Die Position innerhalb des Steuerelements, an der der Suchtext gefunden wurde.

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird ein Textabschnitt in einer RichTextBox nach der ersten Instanz einer Suchzeichenfolge durchsucht, die an den searchText Parameter der Methode übergeben wird. Der Bereich, der innerhalb des Steuerelements nach Text gesucht werden soll, wird durch die searchStart Parameter searchEnd der Methode angegeben. Wenn die Suchzeichenfolge in der RichTextBoxZeichenfolge gefunden wird, gibt die Methode die Indexposition des ersten Zeichens des gefundenen Texts zurück und hebt den gefundenen Text hervor; andernfalls wird ein Wert von -1 zurückgegeben. Im Beispiel wird auch der options Parameter der Find Methode verwendet, um anzugeben, dass der gefundene Text mit der Groß-/Kleinschreibung der Suchzeichenfolge übereinstimmen soll. Das Beispiel erfordert, dass diese Methode in der Klasse eines FormRichTextBox Steuerelements mit dem Namen platziert richTextBox1wird. Nachdem die erste Instanz der Suchzeichenfolge gefunden wurde, können Sie dieses Beispiel verwenden, um andere Instanzen im Text zu finden.

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

Hinweise

Die Find Methode sucht nach dem im str Parameter angegebenen Text und gibt die Position des ersten Zeichens der Suchzeichenfolge innerhalb des Steuerelements zurück. Wenn die Eigenschaft einen negativen Wert zurückgibt, wurde die gesuchte Textzeichenfolge im Inhalt des Steuerelements nicht gefunden. Mit dieser Methode können Sie Suchfunktionen erstellen, die dem Benutzer des Steuerelements zur Verfügung gestellt werden können. Sie können diese Methode auch verwenden, um nach Text zu suchen, der durch ein bestimmtes Format ersetzt werden soll. Wenn der Benutzer beispielsweise Datumsangaben in das Steuerelement eingegeben hat, können Sie mit der Find Methode nach allen Datumsangaben im Dokument suchen und diese durch das entsprechende Format ersetzen, bevor Sie die SaveFile Methode des Steuerelements verwenden.

Mit dieser Version der Find Methode können Sie Optionen angeben, mit denen Sie Die Suche erweitern oder einschränken können. Sie können Optionen angeben, mit denen Sie die Groß-/Kleinschreibung des Suchworts abgleichen oder nach ganzen Wörtern anstelle von Teilwörtern suchen können. Durch Angeben der RichTextBoxFinds.Reverse Aufzählung im options Parameter können Sie nach Text vom unteren Rand des Dokuments bis zum anfang statt nach der standardmäßigen top-to-bottom-Suchmethode suchen. Mit dieser Version der Find Methode können Sie auch die Suche nach Text einschränken, indem Sie eine bestimmte Start- und Endposition im Text des Steuerelements auswählen. Mit diesem Feature können Sie den Suchbereich auf einen bestimmten Abschnitt des Steuerelementtexts beschränken. Wenn dem Parameter ein Wert von negativem Wert (-1) zugewiesen end ist, sucht die Methode bis zum Ende des Texts in den RichTextBox normalen Suchvorgängen. Bei umgekehrten Suchvorgängen gibt ein Wert von negativem (-1) an, der dem end Parameter zugewiesen ist, dass Text vom Ende des Texts (unten) bis zur durch start parameter definierten Position durchsucht wird. Wenn die Parameter und start derselbe end Wert bereitgestellt werden, wird das gesamte Steuerelement nach normalen Suchvorgängen gesucht. Bei einer umgekehrten Suche wird das gesamte Steuerelement durchsucht, aber die Suche beginnt am Ende des Dokuments und sucht am Anfang des Dokuments.