RichTextBox.Find Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Söker efter text i innehållet i RichTextBox.
Överlagringar
| Name | Description |
|---|---|
| Find(Char[]) |
Söker i texten i en RichTextBox kontroll efter den första instansen av ett tecken från en lista med tecken. |
| Find(String) |
Söker i texten i en RichTextBox kontroll efter en sträng. |
| Find(Char[], Int32) |
Söker i texten i en RichTextBox kontroll, vid en viss startpunkt, efter den första instansen av ett tecken från en lista med tecken. |
| Find(String, RichTextBoxFinds) |
Söker i texten i en RichTextBox kontroll efter en sträng med specifika alternativ som tillämpas på sökningen. |
| Find(Char[], Int32, Int32) |
Söker i ett textområde i en RichTextBox kontroll efter den första instansen av ett tecken från en lista med tecken. |
| Find(String, Int32, RichTextBoxFinds) |
Söker i texten i en RichTextBox kontroll efter en sträng på en specifik plats i kontrollen och med specifika alternativ som tillämpas på sökningen. |
| Find(String, Int32, Int32, RichTextBoxFinds) |
Söker i texten i en RichTextBox kontroll efter en sträng inom ett textintervall i kontrollen och med specifika alternativ som tillämpas på sökningen. |
Find(Char[])
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
Söker i texten i en RichTextBox kontroll efter den första instansen av ett tecken från en lista med tecken.
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
Parametrar
- characterSet
- Char[]
Matrisen med tecken att söka efter.
Returer
Platsen i kontrollen där söktecken hittades eller -1 om söktecken inte hittas eller en tom sökteckenuppsättning anges i parametern char .
Exempel
Följande kodexempel söker igenom innehållet i en RichTextBox efter de tecken som skickas till metoden i parametern text . Om innehållet i matrisen text finns i RichTextBoxreturnerar metoden indexet för det värde som hittas. Annars returneras -1. Exemplet kräver att den här metoden placeras i klassen för en Form som innehåller en RichTextBox kontroll med namnet richTextBox1 och en Button kontroll med namnet button1, som är ansluten till den Click händelsehanterare som definierats i exemplet.
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
Kommentarer
Den här versionen av Find metoden söker efter den första instansen av ett tecken från en lista med tecken som anges i parametern characterSet och returnerar tecknets plats. Du kan till exempel skicka en matris med tecken som innehåller tecknet "Q". Om kontrollen innehöll texten "The Quick Brown Fox" Find returnerar metoden värdet fyra. Ett versaler och ett gemener betraktas som olika värden i sökningen.
Om egenskapen returnerar ett negativt värde hittades inte de tecken som söks efter i kontrollens innehåll. Du kan använda den här metoden för att söka efter en grupp tecken i kontrollen. Den här versionen av Find metoden kräver att hela dokumentet i kontrollen söks efter tecknen. Om ett tecken från teckenlistan som anges i metodens parameter hittas characterSet är värdet som returneras av den här metoden ett nollbaserat index för tecknets position i kontrollen. Ett blanksteg betraktas som ett tecken av metoden när du bestämmer platsen för ett tecken.
Gäller för
Find(String)
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
Söker i texten i en RichTextBox kontroll efter en sträng.
public:
int Find(System::String ^ str);
public int Find(string str);
member this.Find : string -> int
Public Function Find (str As String) As Integer
Parametrar
- str
- String
Texten som ska hittas i kontrollen.
Returer
Platsen i kontrollen där söktexten hittades eller -1 om söksträngen inte hittas eller om en tom söksträng anges i parametern str .
Exempel
Följande kodexempel söker igenom hela innehållet i en RichTextBox för den första instansen av en söksträng som skickas till metodens textparameter. Om söksträngen RichTextBoxhittas i returnerar metoden ett värde för true och markerar söktexten, annars returneras false. Exemplet kräver att den här metoden placeras i klassen för en Form som innehåller ett RichTextBox med namnet 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
Kommentarer
Metoden Find söker efter den text som anges i parametern str och returnerar platsen för det första tecknet i kontrollen. Om egenskapen returnerar ett negativt värde hittades inte textsträngen som söks efter i kontrollens innehåll. Du kan använda den här metoden för att skapa sökfunktioner som kan tillhandahållas till användaren av kontrollen. Du kan också använda den här metoden för att söka efter text som ska ersättas med ett visst format. Om användaren till exempel har angett datum i kontrollen kan du använda Find metoden för att söka efter alla datum i dokumentet och ersätta dem med lämpligt format innan du använder SaveFile kontrollens metod.
Note
De Find metoder som accepterar en string som en parameter kan inte hitta text som finns på mer än en textrad i RichTextBox. Om du utför en sådan sökning returneras värdet negativ (-1).
Gäller för
Find(Char[], Int32)
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
Söker i texten i en RichTextBox kontroll, vid en viss startpunkt, efter den första instansen av ett tecken från en lista med tecken.
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
Parametrar
- characterSet
- Char[]
Matrisen med tecken att söka efter.
- start
- Int32
Platsen i kontrollens text som du vill börja söka på.
Returer
Platsen i kontrollen där söktecken hittas.
Exempel
Följande kodexempel söker igenom innehållet i en RichTextBox efter de tecken som skickas till metoden i parametern text . Sökningen börjar från platsen inom den RichTextBox som anges av metodens startFindMyText parameter. Om innehållet i textmatrisen RichTextBoxfinns i returnerar metoden indexet för det värde som hittas. Annars returneras -1. Exemplet kräver att den här metoden placeras i klassen för en Form som innehåller en RichTextBox kontroll med namnet richTextBox1 och en Button kontroll med namnet button1 som är ansluten till händelsehanteraren Click som definierats i exemplet.
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
Kommentarer
Den här versionen av Find metoden söker efter den första instansen av ett tecken från en lista med tecken som anges i parametern characterSet och returnerar tecknets plats. Du kan till exempel skicka en matris med tecken som innehåller tecknet "Q". Om kontrollen innehöll texten "The Quick Brown Fox" Find returnerar metoden värdet fyra. Ett versaler och ett gemener betraktas som olika värden i sökningen.
Om egenskapen returnerar ett negativt värde hittades inte de tecken som söks efter i kontrollens innehåll. Du kan använda den här metoden för att söka efter en grupp tecken i kontrollen. Om ett tecken från teckenlistan som anges i metodens parameter hittas characterSet är värdet som returneras av den här metoden ett nollbaserat index för tecknets position i kontrollen. Ett blanksteg betraktas som ett tecken av metoden när du bestämmer platsen för ett tecken.
Med den Find här versionen av metoden kan du söka efter en teckenuppsättning från en angiven startposition i kontrollens text genom att ange ett värde för parametern start . Värdet noll anger att sökningen ska starta från början av kontrollens dokument. Du kan använda den här versionen av metoden för att begränsa sökningen Find för att undvika text som du redan vet inte innehåller de angivna tecken som du söker efter eller som inte är viktiga i sökningen.
Gäller för
Find(String, RichTextBoxFinds)
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
Söker i texten i en RichTextBox kontroll efter en sträng med specifika alternativ som tillämpas på sökningen.
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
Parametrar
- str
- String
Texten som ska hittas i kontrollen.
- options
- RichTextBoxFinds
En bitvis kombination av RichTextBoxFinds värdena.
Returer
Platsen i kontrollen där söktexten hittades.
Exempel
Följande kodexempel söker igenom hela innehållet i en RichTextBox för den första instansen av en söksträng som skickas till metodens textparameter. Om söksträngen RichTextBoxhittas i returnerar metoden ett värde för true och markerar texten. Annars returneras false. Exemplet anger också alternativ i sökningen för att matcha fallet med den angivna söksträngen. Exemplet kräver att den här metoden placeras i klassen för en Form som innehåller ett RichTextBox med namnet 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
Kommentarer
Metoden Find söker efter den text som anges i parametern str och returnerar platsen för det första tecknet i kontrollen. Om egenskapen returnerar ett negativt värde hittades inte textsträngen som söks efter i kontrollens innehåll. Du kan använda den här metoden för att skapa sökfunktioner som kan tillhandahållas till användaren av kontrollen. Du kan också använda den här metoden för att söka efter text som ska ersättas med ett visst format. Om användaren till exempel har angett datum i kontrollen kan du använda Find metoden för att söka efter alla datum i dokumentet och ersätta dem med lämpligt format innan du använder SaveFile kontrollens metod.
Med den här versionen av metoden kan du ange alternativ som gör att du kan expandera eller begränsa sökningen Find . Du kan ange alternativ som gör att du kan matcha sökordets hölje eller söka efter hela ord i stället för partiella ord. Genom att RichTextBoxFinds.Reverse ange uppräkningen i parametern options kan du söka efter text längst ned i dokumentet längst upp i stället för standardmetoden för topp-till-botten-sökning.
Note
De Find metoder som accepterar en string som en parameter kan inte hitta text som finns på mer än en textrad i RichTextBox. Om du utför en sådan sökning returneras värdet negativ (-1).
Gäller för
Find(Char[], Int32, Int32)
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
Söker i ett textområde i en RichTextBox kontroll efter den första instansen av ett tecken från en lista med tecken.
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
Parametrar
- characterSet
- Char[]
Matrisen med tecken att söka efter.
- start
- Int32
Platsen i kontrollens text som du vill börja söka på.
- end
- Int32
Platsen i kontrollens text där sökningen ska avslutas.
Returer
Platsen i kontrollen där söktecken hittas.
Undantag
characterSet är null.
start är mindre än 0 eller större än längden på texten i kontrollen.
Kommentarer
Den här versionen av Find metoden söker efter den första instansen av ett tecken från en lista med tecken som anges i parametern characterSet och returnerar tecknets plats. Du kan till exempel skicka en matris med tecken som innehåller tecknet "Q". Om kontrollen innehöll texten "The Quick Brown Fox" Find returnerar metoden värdet fyra. Ett versaler och ett gemener betraktas som olika värden i sökningen.
Om egenskapen returnerar ett negativt värde hittades inte de tecken som söks efter i kontrollens innehåll. Du kan använda den här metoden för att söka efter en grupp tecken i kontrollen. Om ett tecken från teckenlistan som anges i metodens parameter hittas characterSet är värdet som returneras av den här metoden ett nollbaserat index för tecknets position i kontrollen. Ett blanksteg betraktas som ett tecken av metoden när du bestämmer platsen för ett tecken.
Med den Find här versionen av metoden kan du söka efter en teckenuppsättning från ett textintervall i kontrollen genom att ange ett värde för parametrarna start och end . Värdet noll för parametern start anger att sökningen ska starta från början av kontrollens dokument. Ett -1 värde för parametern end anger att sökningen ska avslutas i slutet av texten i kontrollen. Du kan använda den här versionen av metoden för att begränsa sökningen Find till ett visst textintervall i kontrollen för att undvika att söka i områden i dokumentet som inte är viktiga för programmets behov.
Gäller för
Find(String, Int32, RichTextBoxFinds)
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
Söker i texten i en RichTextBox kontroll efter en sträng på en specifik plats i kontrollen och med specifika alternativ som tillämpas på sökningen.
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
Parametrar
- str
- String
Texten som ska hittas i kontrollen.
- start
- Int32
Platsen i kontrollens text som du vill börja söka på.
- options
- RichTextBoxFinds
En bitvis kombination av RichTextBoxFinds värdena.
Returer
Platsen i kontrollen där söktexten hittades.
Exempel
Följande kodexempel söker igenom hela innehållet i en RichTextBox för den första instansen av en söksträng som skickas till metodens textparameter. Sökstartplatsen anges av metodens startparameter. Om söksträngen RichTextBoxhittas i returnerar metoden indexplatsen för det första tecknet i den hittade texten och markerar den hittade texten. Annars returneras värdet -1. Exemplet anger också alternativ i sökningen för att matcha fallet med den angivna söksträngen. Exemplet kräver att den här metoden placeras i klassen för en Form som innehåller ett RichTextBox med namnet richTextBox1. Du kan använda det här exemplet för att utföra en "Sök nästa"-typ av åtgärd. När en instans av söktexten har hittats kan du hitta andra instanser av texten genom att ändra värdet för parametern start för att söka på en plats utanför den aktuella matchningens position.
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
Kommentarer
Metoden Find söker efter den text som anges i parametern str och returnerar platsen för det första tecknet i söksträngen i kontrollen. Om egenskapen returnerar ett negativt värde hittades inte textsträngen som söks efter i kontrollens innehåll. Du kan använda den här metoden för att skapa sökfunktioner som kan tillhandahållas till användaren av kontrollen. Du kan också använda den här metoden för att söka efter text som ska ersättas med ett visst format. Om användaren till exempel har angett datum i kontrollen kan du använda Find metoden för att söka efter alla datum i dokumentet och ersätta dem med lämpligt format innan du använder SaveFile kontrollens metod.
Med den här versionen av metoden kan du ange alternativ som gör att du kan expandera eller begränsa sökningen Find . Du kan ange alternativ som gör att du kan matcha sökordets hölje eller söka efter hela ord i stället för partiella ord. Genom att RichTextBoxFinds.Reverse ange uppräkningen i parametern options kan du söka efter text längst ned i dokumentet längst upp i stället för standardmetoden för topp-till-botten-sökning. Med den Find här versionen av metoden kan du också begränsa sökningen efter text genom att välja en specifik startposition i kontrollens text. Med den här funktionen kan du undvika text som kanske redan har genomsökts eller där den specifika text som du söker efter inte finns. När värdet RichTextBoxFinds.Reverse anges i parametern options anger värdet för parametern start den position där den omvända sökningen slutar eftersom sökningen startar längst ned i dokumentet när du använder den Find här versionen av metoden.
Note
De Find metoder som accepterar en string som en parameter kan inte hitta text som finns på mer än en textrad i RichTextBox. Om du utför en sådan sökning returneras värdet negativ (-1).
Gäller för
Find(String, Int32, Int32, RichTextBoxFinds)
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
- Källa:
- RichTextBox.cs
Söker i texten i en RichTextBox kontroll efter en sträng inom ett textintervall i kontrollen och med specifika alternativ som tillämpas på sökningen.
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
Parametrar
- str
- String
Texten som ska hittas i kontrollen.
- start
- Int32
Platsen i kontrollens text som du vill börja söka på.
- end
- Int32
Platsen i kontrollens text där sökningen ska avslutas. Det här värdet måste vara lika med negativt (-1) eller större än eller lika med parametern start .
- options
- RichTextBoxFinds
En bitvis kombination av RichTextBoxFinds värdena.
Returer
Platsen i kontrollen där söktexten hittades.
Undantag
Parametern str var null.
Parametern start var mindre än noll.
-eller-
Parametern end var mindre parametern start .
Exempel
Följande kodexempel söker igenom ett textavsnitt i en RichTextBox för den första instansen av en söksträng som skickas till searchText metodens parameter. Intervallet för att söka efter text i kontrollen anges av searchStart metodens parametrar och searchEnd . Om söksträngen RichTextBoxhittas i returnerar metoden indexplatsen för det första tecknet i den hittade texten och markerar den hittade texten. Annars returneras värdet -1. I exemplet används även parametern options för Find metoden för att ange att den hittade texten ska matcha söksträngens skiftläge. Exemplet kräver att den här metoden placeras i klassen för en Form som innehåller en RichTextBox kontroll med namnet richTextBox1. När den första instansen av söksträngen har hittats kan du använda det här exemplet för att hitta andra instanser i texten.
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
Kommentarer
Metoden Find söker efter den text som anges i parametern str och returnerar platsen för det första tecknet i söksträngen i kontrollen. Om egenskapen returnerar ett negativt värde hittades inte textsträngen som söks efter i kontrollens innehåll. Du kan använda den här metoden för att skapa sökfunktioner som kan tillhandahållas till användaren av kontrollen. Du kan också använda den här metoden för att söka efter text som ska ersättas med ett visst format. Om användaren till exempel har angett datum i kontrollen kan du använda Find metoden för att söka efter alla datum i dokumentet och ersätta dem med lämpligt format innan du använder SaveFile kontrollens metod.
Med den här versionen av metoden kan du ange alternativ som gör att du kan expandera eller begränsa sökningen Find . Du kan ange alternativ som gör att du kan matcha sökordets hölje eller söka efter hela ord i stället för partiella ord. Genom att RichTextBoxFinds.Reverse ange uppräkningen i parametern options kan du söka efter text längst ned i dokumentet längst upp i stället för standardmetoden för topp-till-botten-sökning. Med den Find här versionen av metoden kan du också begränsa sökningen efter text genom att välja en specifik start- och slutposition i kontrollens text. Med den här funktionen kan du begränsa sökområdet till ett visst avsnitt i kontrollens text. Om värdet negativ (-1) tilldelas till parametern end , söker metoden till slutet av texten i RichTextBox för normala sökningar. För omvända sökningar anger ett värde på negativ (-1) som tilldelats parametern end att texten kommer att sökas från slutet av texten (längst ned) till den position som definieras av start parametern. När parametrarna start och end anges samma värde genomsöks hela kontrollen efter normala sökningar. För en omvänd sökning genomsöks hela kontrollen, men sökningen börjar längst ned i dokumentet och söker längst upp i dokumentet.
Note
De Find metoder som accepterar en string som en parameter kan inte hitta text som finns på mer än en textrad i RichTextBox. Om du utför en sådan sökning returneras värdet negativ (-1).