RichTextBoxFinds Enumeration

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Gibt an, wie eine Textsuche in einem RichTextBox-Steuerelement ausgeführt wird.

Diese Enumeration unterstützt eine bitweise Kombination ihrer Memberwerte.

public enum class RichTextBoxFinds

[System.Flags]
public enum RichTextBoxFinds

[<System.Flags>]
type RichTextBoxFinds = 

Public Enum RichTextBoxFinds

Vererbung

Object

ValueType

Enum

RichTextBoxFinds

Attribute

FlagsAttribute

Felder

MatchCase	4	Sucht nur Instanzen des Suchtexts, die eine vollständige Übereinstimmung der Groß- und Kleinschreibung aufweisen.
NoHighlight	8	Der Suchtext soll, sofern dieser gefunden wird, nicht markiert werden.
None	0	Sucht alle Instanzen des Suchtexts unabhängig davon, ob die in der Suche gefunden Instanzen ganze Wörter darstellen.
Reverse	16	Die Suche wird am Ende des Dokuments im Steuerelement begonnen und bis zum Anfang des Dokuments fortgeführt.
WholeWord	2	Sucht nur Instanzen des Suchtexts, die ganze Wörter darstellen.

Beispiele

Im folgenden Beispiel wird der gesamte Inhalt einer RichTextBox nach der ersten Instanz einer Suchzeichenfolge durchsucht, die an den text-Parameter der -Methode übergeben wird. Der Startort der Suche wird durch den start-Parameter der -Methode angegeben. Wenn die Suchzeichenfolge im RichTextBoxgefunden wird, gibt die Methode die Indexposition des ersten Zeichens des gefundenen Texts zurück und hebt den gefundenen Text hervor. Andernfalls gibt sie den Wert -1 zurück. Das Beispiel gibt auch Optionen in der Suche an, die der Groß-/Kleinschreibung der angegebenen Suchzeichenfolge entsprechen. Im Beispiel wird davon ausgegangen, dass diese Methode in der -Klasse einer Form platziert wird, die einen RichTextBox namens richTextBox1enthält. Sie können dieses Beispiel verwenden, wenn Sie einen Typvorgang vom Typ "Weiter suchen" ausführen, nachdem die erste Instanz von Suchtext gefunden wurde, um andere Instanzen des Texts zu finden.

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

Eine Anwendung sucht Text im RichTextBox Steuerelement, indem die Find -Methode des RichTextBox Steuerelements aufgerufen wird. Mit dieser Enumeration können Sie angeben, wie die Suche ausgeführt wird, wenn die Find -Methode aufgerufen wird. Sie können einen oder mehrere Werte aus dieser Enumeration kombinieren, um beim Aufrufen der Find -Methode mehrere Suchoptionen anzugeben.

Weitere Informationen

• RichTextBox
• Find(String)