RichTextBoxFinds-Enumeration

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

Diese Enumeration verfügt über ein FlagsAttribute -Attribut, das die bitweise Kombination der Memberwerte zulässt.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
<FlagsAttribute> _
Public Enumeration RichTextBoxFinds
'Usage
Dim instance As RichTextBoxFinds

[FlagsAttribute] 
public enum RichTextBoxFinds

[FlagsAttribute] 
public enum class RichTextBoxFinds

/** @attribute FlagsAttribute() */ 
public enum RichTextBoxFinds

FlagsAttribute 
public enum RichTextBoxFinds

Member

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

Hinweise

Eine Anwendung sucht Text im RichTextBox-Steuerelement durch einen Aufruf der Find-Methode des RichTextBox-Steuerelements. Mit dieser Enumeration können Sie angeben, wie die Suche ausgeführt wird, wenn die Find-Methode aufgerufen wird. Beim Aufrufen der Find-Methode können Sie mit einem Wert bzw. einer Kombination mehrerer Werte aus dieser Enumeration mehrere Suchoptionen angeben.

Beispiel

Im folgenden Beispiel wird der gesamte Inhalt einer RichTextBox nach der ersten Instanz einer Suchzeichenfolge durchsucht, die an den Textparameter der Methode übergeben wurde. Der Anfangspunkt der Suche wird vom Startparameter der Methode angegeben. Wenn die Suchzeichenfolge in RichTextBox gefunden wurde, gibt die Methode die Indexposition des ersten Zeichens des gefundenen Texts zurück und hebt diesen hervor. Andernfalls gibt sie den Wert -1 zurück. Im Beispiel werden auch Suchoptionen angegeben, mit denen in der angegebenen Suchzeichenfolge Groß- und Kleinbuchstaben unterschieden werden. In diesem Beispiel wird davon ausgegangen, dass diese Methode sich in der Klasse eines Form befindet, das die RichTextBox mit dem Namen richTextBox1 enthält. Dieses Beispiel können Sie verwenden, wenn Sie, nachdem die erste Instanz des Suchtexts gefunden wurde, einen Vorgang vom Typ "Weitersuchen" ausführen, um weitere Instanzen des Texts zu suchen.

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

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 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.get_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;
} //FindMyText

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

System.Windows.Forms-Namespace
RichTextBox-Klasse
RichTextBox.Find