RichTextBoxFinds Enumeration
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
- Attribute
Felder
| Name | Wert | Beschreibung |
|---|---|---|
| None | 0 | Suchen Sie alle Instanzen des Suchtexts, unabhängig davon, ob die in der Suche gefundenen Instanzen ganze Wörter sind oder nicht. |
| WholeWord | 2 | Suchen Sie nur Instanzen des Suchtexts, die ganze Wörter sind. |
| MatchCase | 4 | Suchen Sie nur Instanzen des Suchtexts mit der genauen Groß-/Kleinschreibung. |
| NoHighlight | 8 | Der Suchtext sollte, falls gefunden, nicht hervorgehoben werden. |
| Reverse | 16 | Die Suche beginnt am Ende des Steuerelementdokuments und sucht am Anfang des Dokuments. |
Beispiele
Im folgenden Beispiel wird der gesamte Inhalt einer RichTextBox Suchzeichenfolge für die erste Instanz einer 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. In diesem Beispiel wird davon ausgegangen, dass diese Methode in der Klasse einer Form Klasse platziert wird, die einen RichTextBox benannten Namen richTextBox1enthält. Sie können dieses Beispiel verwenden, wenn Sie einen "Find Next"-Typvorgang ausführen, nachdem die erste Instanz des Suchtexts 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.
