Sdílet prostřednictvím

RichTextBox.Find Metoda

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

Vyhledá text v obsahu objektu RichTextBox.

Přetížení

Find(Char[])

Vyhledá první výskyt znaku RichTextBox ze seznamu znaků v textu ovládacího prvku.
Find(String)

Vyhledá řetězec v textu v ovládacím RichTextBox prvku.
Find(Char[], Int32)

Vyhledá v textu RichTextBox ovládacího prvku v určitém počátečním bodě první výskyt znaku ze seznamu znaků.
Find(String, RichTextBoxFinds)

Vyhledá v textu v ovládacím RichTextBox prvku řetězec s konkrétními možnostmi použitými pro hledání.
Find(Char[], Int32, Int32)

Vyhledá oblast textu v ovládacím RichTextBox prvku pro první výskyt znaku ze seznamu znaků.
Find(String, Int32, RichTextBoxFinds)

Vyhledá v textu v ovládacím RichTextBox prvku řetězec na určitém místě v rámci ovládacího prvku a s konkrétními možnostmi použitými pro hledání.
Find(String, Int32, Int32, RichTextBoxFinds)

Vyhledá text v ovládacím RichTextBox prvku pro řetězec v rozsahu textu v rámci ovládacího prvku a s konkrétními možnostmi použitými pro hledání.

Find(Char[])

Vyhledá první výskyt znaku RichTextBox ze seznamu znaků v textu ovládacího prvku.

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

Parametry

characterSet
Char[]

Pole znaků, které chcete vyhledat.

Návraty

Int32

Umístění v ovládacím prvku, kde byly nalezeny znaky hledání, nebo -1, pokud nejsou nalezeny hledané znaky nebo prázdná znaková sada hledání je zadána v parametru char .

Příklady

Následující příklad kódu prohledá obsah objektu pro RichTextBox znaky, které jsou předány metodě v parametru text . Pokud je obsah text pole nalezen v objektu RichTextBox, vrátí metoda index nalezené hodnoty; v opačném případě vrátí hodnotu -1. Příklad vyžaduje, aby tato metoda byla umístěna ve třídě Form , která obsahuje RichTextBox ovládací prvek s názvem richTextBox1 a Button ovládací prvek s názvem button1, který je připojen k Click obslužné rutině události definované v příkladu.

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

Poznámky

Tato verze Find metody vyhledá první instanci znaku ze seznamu znaků zadaných v parametru characterSet a vrátí umístění znaku. Například předáte pole znaků obsahující znak "Q". Pokud ovládací prvek obsahoval text "Rychlá hnědá liška", Find metoda by vrátila hodnotu čtyři. Velké a malé znaky se při hledání považují za různé hodnoty.

Pokud vlastnost vrátí zápornou hodnotu, hledané znaky nebyly nalezeny v obsahu ovládacího prvku. Tuto metodu můžete použít k vyhledání skupiny znaků v ovládacím prvku. Tato verze Find metody vyžaduje, aby znaky byly prohledány v celém dokumentu obsaženém v ovládacím prvku. Pokud je nalezen znak ze seznamu znaků zadaný v parametru metody characterSet , hodnota vrácená touto metodou je index od nuly pozice znaku v ovládacím prvku. Mezera je považována metodou za znak při určování umístění znaku.

Platí pro

Find(String)

Vyhledá řetězec v textu v ovládacím RichTextBox prvku.

public:
 int Find(System::String ^ str);
public int Find (string str);
member this.Find : string -> int
Public Function Find (str As String) As Integer

Parametry

str
String

Text, který se má v ovládacím prvku najít.

Návraty

Int32

Umístění v ovládacím prvku, kde byl nalezen hledaný text, nebo -1, pokud nebyl nalezen hledaný řetězec nebo prázdný hledaný řetězec je zadán v parametru str .

Příklady

Následující příklad kódu prohledá celý obsah objektu RichTextBox pro první instanci vyhledávacího řetězce předaného do textového parametru metody. Pokud je hledaný řetězec nalezen v RichTextBox, vrátí metoda hodnotu true a zvýrazní hledaný text, jinak vrátí falsehodnotu . Příklad vyžaduje, aby tato metoda byla umístěna ve třídě objektu Form , který obsahuje pojmenovanou RichTextBoxrichTextBox1.

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

Poznámky

Metoda Find vyhledá text zadaný v parametru str a vrátí umístění prvního znaku v ovládacím prvku. Pokud vlastnost vrátí zápornou hodnotu, textový řetězec nebyl nalezen v obsahu ovládacího prvku. Pomocí této metody můžete vytvořit vyhledávací funkce, které lze poskytnout uživateli ovládacího prvku. Tuto metodu můžete použít také k vyhledání textu, který má být nahrazen určitým formátem. Pokud například uživatel zadal data do ovládacího prvku, můžete použít metodu Find k vyhledání všech kalendářních dat v dokumentu a nahradit je odpovídajícím formátem před použitím SaveFile metody ovládacího prvku.

Poznámka

Metody Find , které přijímají string parametr jako parametr, nemohou najít text, který je obsažen na více než jednom řádku textu v rámci objektu RichTextBox. Provedení takového hledání vrátí zápornou hodnotu (-1).

Platí pro

Find(Char[], Int32)

Vyhledá v textu RichTextBox ovládacího prvku v určitém počátečním bodě první výskyt znaku ze seznamu znaků.

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

Parametry

characterSet
Char[]

Pole znaků, které chcete vyhledat.

start
Int32

Umístění v textu ovládacího prvku, ve kterém se má začít hledat.

Návraty

Int32

Umístění v ovládacím prvku, kde jsou nalezeny hledané znaky.

Příklady

Následující příklad kódu prohledá obsah objektu pro RichTextBox znaky, které jsou předány metodě v parametru text . Hledání začíná od umístění v rámci RichTextBox zadaného parametrem startFindMyText metody. Pokud je obsah textového pole nalezen v objektu RichTextBox, vrátí metoda index nalezené hodnoty; v opačném případě vrátí hodnotu -1. Příklad vyžaduje, aby tato metoda byla umístěna ve třídě Form , která obsahuje RichTextBox ovládací prvek s názvem richTextBox1 a Button ovládací prvek s názvem button1 , který je připojen k Click obslužné rutině události definované v příkladu.

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

Poznámky

Tato verze Find metody vyhledá první instanci znaku ze seznamu znaků zadaných v parametru characterSet a vrátí umístění znaku. Například předáte pole znaků obsahující znak "Q". Pokud ovládací prvek obsahoval text "Rychlá hnědá liška", Find metoda by vrátila hodnotu čtyři. Velké a malé znaky se při hledání považují za různé hodnoty.

Pokud vlastnost vrátí zápornou hodnotu, hledané znaky nebyly nalezeny v obsahu ovládacího prvku. Tuto metodu můžete použít k vyhledání skupiny znaků v ovládacím prvku. Pokud je nalezen znak ze seznamu znaků zadaný v parametru metody characterSet , hodnota vrácená touto metodou je index od nuly pozice znaku v ovládacím prvku. Mezera je považována metodou za znak při určování umístění znaku.

Tato verze Find metody umožňuje vyhledat znakovou sadu ze zadané počáteční pozice v textu ovládacího prvku zadáním hodnoty parametru start . Hodnota nula označuje, že hledání by mělo začít od začátku dokumentu ovládacího prvku. Tuto verzi Find metody můžete použít ke zúžení hledání, abyste se vyhnuli textu, o který už víte, že neobsahuje zadané znaky, které hledáte, nebo nejsou při hledání důležité.

Platí pro

Find(String, RichTextBoxFinds)

Vyhledá v textu v ovládacím RichTextBox prvku řetězec s konkrétními možnostmi použitými pro hledání.

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

Parametry

str
String

Text, který se má v ovládacím prvku najít.

options
RichTextBoxFinds

Bitové kombinace RichTextBoxFinds hodnot.

Návraty

Int32

Umístění v ovládacím prvku, kde byl nalezen hledaný text.

Příklady

Následující příklad kódu prohledá celý obsah objektu RichTextBox pro první instanci vyhledávacího řetězce předaného do textového parametru metody. Pokud je hledaný řetězec nalezen v RichTextBox, vrátí metoda hodnotu true a zvýrazní text. V opačném případě vrátí falsehodnotu . Příklad také určuje možnosti hledání tak, aby odpovídaly případu zadaného vyhledávacího řetězce. Příklad vyžaduje, aby tato metoda byla umístěna ve třídě objektu Form , který obsahuje pojmenovanou RichTextBoxrichTextBox1.

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

Poznámky

Metoda Find vyhledá text zadaný v parametru str a vrátí umístění prvního znaku v ovládacím prvku. Pokud vlastnost vrátí zápornou hodnotu, textový řetězec nebyl nalezen v obsahu ovládacího prvku. Pomocí této metody můžete vytvořit vyhledávací funkce, které lze poskytnout uživateli ovládacího prvku. Tuto metodu můžete použít také k vyhledání textu, který má být nahrazen určitým formátem. Pokud například uživatel zadal data do ovládacího prvku, můžete pomocí Find metody vyhledat všechna data v dokumentu a nahradit je odpovídajícím formátem před použitím SaveFile metody ovládacího prvku.

V této verzi Find metody můžete zadat možnosti, které vám umožní rozšířit nebo zúžit hledání. Můžete zadat možnosti, které vám umožní spárovat velikost písmen hledaného slova nebo hledat celá slova místo částečných slov. Zadáním výčtu RichTextBoxFinds.Reverse v parametru options můžete hledat text odspodu dokumentu nahoru místo výchozí metody hledání shora.

Poznámka

Metody Find , které přijímají string parametr jako parametr, nemohou najít text, který je obsažen na více než jednom řádku textu v rámci objektu RichTextBox. Provedení takového hledání vrátí zápornou hodnotu (-1).

Platí pro

Find(Char[], Int32, Int32)

Vyhledá oblast textu v ovládacím RichTextBox prvku pro první výskyt znaku ze seznamu znaků.

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

Parametry

characterSet
Char[]

Pole znaků, které chcete vyhledat.

start
Int32

Umístění v textu ovládacího prvku, ve kterém se má začít hledat.

end
Int32

Umístění v textu ovládacího prvku, na kterém se má hledání ukončit.

Návraty

Int32

Umístění v ovládacím prvku, kde jsou nalezeny hledané znaky.

Výjimky

ArgumentNullException

characterSet je null.

ArgumentException

start je menší než 0 nebo větší než délka textu v ovládacím prvku.

Poznámky

Tato verze Find metody vyhledá první instanci znaku ze seznamu znaků zadaných v parametru characterSet a vrátí umístění znaku. Například předáte pole znaků obsahující znak "Q". Pokud ovládací prvek obsahoval text "Rychlá hnědá liška", Find metoda by vrátila hodnotu čtyři. Velké a malé znaky se při hledání považují za různé hodnoty.

Pokud vlastnost vrátí zápornou hodnotu, hledané znaky nebyly nalezeny v obsahu ovládacího prvku. Tuto metodu můžete použít k vyhledání skupiny znaků v ovládacím prvku. Pokud je nalezen znak ze seznamu znaků zadaný v parametru metody characterSet , je hodnota vrácená touto metodou indexem nulové pozice znaku v ovládacím prvku. Mezera je považována metodou za znak při určování umístění znaku.

Tato verze Find metody umožňuje vyhledat znakovou sadu z rozsahu textu v ovládacím prvku zadáním hodnoty start parametrů a end . Hodnota nula parametru start označuje, že hledání by mělo být zahájeno od začátku dokumentu ovládacího prvku. Hodnota -1 parametru end označuje, že hledání by mělo končit na konci textu v ovládacím prvku. Tuto verzi Find metody můžete použít k zúžení hledání na konkrétní rozsah textu v rámci ovládacího prvku, abyste se vyhnuli oblastem hledání v dokumentu, které nejsou důležité pro potřeby vaší aplikace.

Platí pro

Find(String, Int32, RichTextBoxFinds)

Vyhledá v textu v ovládacím RichTextBox prvku řetězec na určitém místě v rámci ovládacího prvku a s konkrétními možnostmi použitými pro hledání.

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

Parametry

str
String

Text, který se má v ovládacím prvku najít.

start
Int32

Umístění v textu ovládacího prvku, ve kterém se má začít hledat.

options
RichTextBoxFinds

Bitové kombinace RichTextBoxFinds hodnot.

Návraty

Int32

Umístění v ovládacím prvku, kde byl nalezen hledaný text.

Příklady

Následující příklad kódu prohledá celý obsah objektu RichTextBox pro první instanci vyhledávacího řetězce předaného do textového parametru metody. Počáteční umístění hledání je určeno parametrem start metody. Pokud je hledaný řetězec nalezen v objektu RichTextBox, vrátí metoda umístění indexu prvního znaku nalezeného textu a zvýrazní nalezený text. V opačném případě vrátí hodnotu -1. Příklad také určuje možnosti hledání tak, aby odpovídaly případu zadaného vyhledávacího řetězce. Příklad vyžaduje, aby tato metoda byla umístěna ve třídě objektu Form , který obsahuje pojmenovanou RichTextBoxrichTextBox1. Tento příklad můžete použít k provedení operace typu Najít další. Jakmile je nalezena instance hledaného textu, můžete najít další instance textu tak, že změníte hodnotu parametru start tak, aby se hledal v umístění mimo pozici aktuální shody.

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

Poznámky

Metoda Find vyhledá text zadaný v parametru str a vrátí umístění prvního znaku vyhledávacího řetězce v ovládacím prvku. Pokud vlastnost vrátí zápornou hodnotu, textový řetězec nebyl nalezen v obsahu ovládacího prvku. Pomocí této metody můžete vytvořit vyhledávací funkce, které lze poskytnout uživateli ovládacího prvku. Tuto metodu můžete použít také k vyhledání textu, který má být nahrazen určitým formátem. Pokud například uživatel zadal data do ovládacího prvku, můžete použít metodu Find k vyhledání všech kalendářních dat v dokumentu a nahradit je odpovídajícím formátem před použitím SaveFile metody ovládacího prvku.

V této verzi Find metody můžete zadat možnosti, které vám umožní rozšířit nebo zúžit hledání. Můžete zadat možnosti, které vám umožní spárovat velikost písmen hledaného slova nebo hledat celá slova místo částečných slov. Zadáním výčtu RichTextBoxFinds.Reverse v parametru options můžete hledat text odspodu dokumentu nahoru místo výchozí metody hledání shora. Tato verze Find metody také umožňuje zúžit hledání textu výběrem konkrétní počáteční pozice v textu ovládacího prvku. Tato funkce vám umožní vyhnout se textu, který už mohl být prohledávaný nebo u kterého je známo, že konkrétní text, který hledáte, neexistuje. RichTextBoxFinds.Reverse Pokud je hodnota zadána v parametruoptions, hodnota parametru start označuje pozici, kde zpětné hledání skončí, protože hledání začne v dolní části dokumentu při použití této verze Find metody.

Poznámka

Metody Find , které přijímají string parametr jako parametr, nemohou najít text, který je obsažen na více než jednom řádku textu v rámci objektu RichTextBox. Provedení takového hledání vrátí zápornou hodnotu (-1).

Platí pro

Find(String, Int32, Int32, RichTextBoxFinds)

Vyhledá text v ovládacím RichTextBox prvku pro řetězec v rozsahu textu v rámci ovládacího prvku a s konkrétními možnostmi použitými pro hledání.

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

Parametry

str
String

Text, který se má v ovládacím prvku najít.

start
Int32

Umístění v textu ovládacího prvku, ve kterém se má začít hledat.

end
Int32

Umístění v textu ovládacího prvku, na kterém se má hledání ukončit. Tato hodnota musí být rovna záporné hodnotě 1 (-1) nebo větší než nebo rovna parametru start .

options
RichTextBoxFinds

Bitové kombinace RichTextBoxFinds hodnot.

Návraty

Int32

Umístění v ovládacím prvku, kde byl nalezen hledaný text.

Výjimky

ArgumentNullException

Parametr str byl null.

ArgumentException

Parametr start byl menší než nula.

-nebo-

Parametr end byl menší než start parametr.

Příklady

Následující příklad kódu hledá část textu v objektu RichTextBox pro první instanci vyhledávacího řetězce předaného do searchText parametru metody. Oblast pro vyhledávání textu v rámci ovládacího prvku je určena searchStart parametry a searchEnd metody. Pokud je hledaný řetězec nalezen v objektu RichTextBox, vrátí metoda umístění indexu prvního znaku nalezeného textu a zvýrazní nalezený text. V opačném případě vrátí hodnotu -1. Příklad také používá options parametr Find metody k určení, že nalezený text by měl odpovídat velikosti písmen vyhledávacího řetězce. Příklad vyžaduje, aby tato metoda byla umístěna ve třídě objektu Form , který obsahuje ovládací prvek RichTextBox s názvem richTextBox1. Po nalezení první instance vyhledávacího řetězce můžete tento příklad použít k vyhledání dalších instancí v textu.

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

Poznámky

Metoda Find vyhledá text zadaný v parametru str a vrátí umístění prvního znaku vyhledávacího řetězce v ovládacím prvku. Pokud vlastnost vrátí zápornou hodnotu, textový řetězec nebyl nalezen v obsahu ovládacího prvku. Pomocí této metody můžete vytvořit vyhledávací funkce, které lze poskytnout uživateli ovládacího prvku. Tuto metodu můžete použít také k vyhledání textu, který má být nahrazen určitým formátem. Pokud například uživatel zadal data do ovládacího prvku, můžete pomocí Find metody vyhledat všechna data v dokumentu a nahradit je odpovídajícím formátem před použitím SaveFile metody ovládacího prvku.

V této verzi Find metody můžete zadat možnosti, které vám umožní rozšířit nebo zúžit hledání. Můžete zadat možnosti, které vám umožní spárovat velikost písmen hledaného slova nebo hledat celá slova místo částečných slov. Zadáním výčtu RichTextBoxFinds.Reverse v parametru options můžete hledat text odspodu dokumentu nahoru místo výchozí metody hledání shora. Tato verze Find metody také umožňuje zúžit hledání textu výběrem konkrétní počáteční a koncové pozice v textu ovládacího prvku. Tato funkce umožňuje omezit rozsah hledání na určitou část textu ovládacího prvku. Pokud je parametru end přiřazena záporná hodnota 1 (-1), bude metoda hledat až do konce textu v RichTextBox poli pro normální hledání. V případě zpětného hledání hodnota záporné hodnoty (-1) přiřazené parametru end označuje, že text bude prohledána od konce textu (dolů) do pozice definované parametrem start . start Pokud jsou parametry a end zadané se stejnou hodnotou, vyhledá se pro normální hledání celý ovládací prvek. Při zpětném hledání se prohledá celý ovládací prvek, ale hledání začíná v dolní části dokumentu a hledá se v horní části dokumentu.

Poznámka

Metody Find , které přijímají string parametr jako parametr, nemohou najít text, který je obsažen na více než jednom řádku textu v rámci objektu RichTextBox. Provedení takového hledání vrátí zápornou hodnotu (-1).

Platí pro