RichTextBox.Find Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Vyhledá text v obsahu RichTextBoxsouboru .

Přetížení

Name	Description
Find(Char[])	Vyhledá text RichTextBox ovládacího prvku pro první instanci znaku ze seznamu znaků.
Find(String)	Vyhledá text v ovládacím RichTextBox prvku řetězec.
Find(Char[], Int32)	Vyhledá text RichTextBox ovládacího prvku v určitém počátečním bodě pro první instanci znaku ze seznamu znaků.
Find(String, RichTextBoxFinds)	Vyhledá text 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í instanci znaku ze seznamu znaků.
Find(String, Int32, RichTextBoxFinds)	Vyhledá text v ovládacím RichTextBox prvku řetězec v určitém umístění v ovládacím 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 řetězec v rozsahu textu v ovládacím prvku a s konkrétními možnostmi použitými pro hledání.

Find(Char[])

Zdroj:

RichTextBox.cs

Vyhledá text RichTextBox ovládacího prvku pro první instanci znaku ze seznamu znaků.

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[]

Poleznakůch

Návraty

Int32

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

Příklady

Následující příklad kódu prohledá obsah RichTextBox znaků, které jsou předány metodě v parametru text . Pokud je obsah text pole nalezen v RichTextBox, metoda vrátí index nalezené hodnoty; v opačném případě vrátí -1. Příklad vyžaduje, aby tato metoda byla umístěna ve třídě Form , která obsahuje RichTextBox ovládací prvek pojmenovaný richTextBox1Button a 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 characterSet parametru a vrátí umístění znaku. Například předáte pole znaků obsahující znak "Q". Pokud ovládací prvek obsahoval text "The Quick Brown Fox", Find metoda by vrátila hodnotu čtyř. Velká a malá písmena jsou při hledání považovány za různé hodnoty.

Pokud vlastnost vrátí zápornou hodnotu, znaky, které se hledají, 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 se znaky vyhledaly celý dokument obsažený v ovládacím prvku. Pokud je nalezen znak ze seznamu znaků zadaný v parametru characterSet metody, hodnota vrácená touto metodou je index založený na nule pozice znaku v ovládacím prvku. Mezera je považována za znak metodou při určování umístění znaku.

Find(String)

Zdroj:

RichTextBox.cs

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

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ý chcete vyhledat v ovládacím prvku.

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 je v parametru str zadán prázdný hledaný řetězec.

Příklady

Následující příklad kódu prohledá celý obsah RichTextBox první instance vyhledávacího řetězce předaného do textového parametru metody. Pokud je hledaný řetězec nalezen v RichTextBox, metoda vrátí hodnotu true a zvýrazní hledaný text, jinak vrátí false. Příklad vyžaduje, aby tato metoda byla umístěna ve třídě Form , která obsahuje pojmenovaný 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, který hledáte, nebyl nalezen v obsahu ovládacího prvku. Tuto metodu můžete použít k vytvoření funkce vyhledávání, které lze poskytnout uživateli ovládacího prvku. Tuto metodu můžete použít také k vyhledání textu, který se má nahradit 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.

Note

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

Find(Char[], Int32)

Zdroj:

RichTextBox.cs

Vyhledá text RichTextBox ovládacího prvku v určitém počátečním bodě pro první instanci 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[]

Poleznakůch

start

Int32

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

Návraty

Int32

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

Příklady

Následující příklad kódu prohledá obsah RichTextBox znaků, které jsou předány metodě v parametru text . Hledání začíná z umístění v zadaném RichTextBoxstart parametrem FindMyText metody. Pokud je obsah textového pole nalezen v RichTextBox, metoda vrátí index nalezené hodnoty; v opačném případě vrátí -1. Příklad vyžaduje, aby tato metoda byla umístěna ve tříděForm, která obsahuje ovládací prvek pojmenovaný RichTextBoxrichTextBox1 a Button ovládací prvek s názvembutton1, 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 characterSet parametru a vrátí umístění znaku. Například předáte pole znaků obsahující znak "Q". Pokud ovládací prvek obsahoval text "The Quick Brown Fox", Find metoda by vrátila hodnotu čtyř. Velká a malá písmena jsou při hledání považovány za různé hodnoty.

Pokud vlastnost vrátí zápornou hodnotu, znaky, které se hledají, 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 characterSet metody, hodnota vrácená touto metodou je index založený na nule pozice znaku v ovládacím prvku. Mezera je považována za znak metodou 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čínat od začátku dokumentu ovládacího prvku. Tuto verzi Find metody můžete použít k zúžení hledání, abyste se vyhnuli textu, který už víte, neobsahuje zadané znaky, které hledáte nebo které nejsou ve vyhledávání důležité.

Find(String, RichTextBoxFinds)

Zdroj:

RichTextBox.cs

Vyhledá text 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ý chcete vyhledat v ovládacím prvku.

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 RichTextBox první instance vyhledávacího řetězce předaného do textového parametru metody. Pokud je hledaný řetězec nalezen v RichTextBox, metoda vrátí hodnotu true textu a zvýrazní text; v opačném případě vrátí false. Příklad také určuje možnosti hledání, které odpovídají případu zadaného vyhledávacího řetězce. Příklad vyžaduje, aby tato metoda byla umístěna ve třídě Form , která obsahuje pojmenovaný 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, který hledáte, nebyl nalezen v obsahu ovládacího prvku. Tuto metodu můžete použít k vytvoření funkce vyhledávání, které lze poskytnout uživateli ovládacího prvku. Tuto metodu můžete použít také k vyhledání textu, který se má nahradit 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.

Pomocí této verze Find metody můžete zadat možnosti, které umožňují rozbalit nebo zúžit hledání. Můžete zadat možnosti, které umožňují shodovat velikost textu 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 z dolní části dokumentu na začátek namísto výchozí metody hledání shora dolů.

Note

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

Find(Char[], Int32, Int32)

Zdroj:

RichTextBox.cs

Vyhledá oblast textu v ovládacím RichTextBox prvku pro první instanci 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[]

Poleznakůch

start

Int32

Umístění v textu ovládacího prvku, ve kterém chcete 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 znaky hledání.

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 characterSet parametru a vrátí umístění znaku. Například předáte pole znaků obsahující znak "Q". Pokud ovládací prvek obsahoval text "The Quick Brown Fox", Find metoda by vrátila hodnotu čtyř. Velká a malá písmena jsou při hledání považovány za různé hodnoty.

Pokud vlastnost vrátí zápornou hodnotu, znaky, které se hledají, 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 se najde znak ze seznamu znaků zadaný v parametru characterSet metody, hodnota vrácená touto metodou je nulový index pozice znaku v ovládacím prvku. Mezera je považována za znak metodou 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 pro parametrystart.end Hodnota nula parametru start označuje, že hledání by mělo začínat 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. Pomocí této verze Find metody můžete hledání zúžit na konkrétní oblast textu v ovládacím prvku, abyste se vyhnuli oblastem hledání v dokumentu, které nejsou pro potřeby vaší aplikace důležité.

Find(String, Int32, RichTextBoxFinds)

Zdroj:

RichTextBox.cs

Vyhledá text v ovládacím RichTextBox prvku řetězec v určitém umístění v ovládacím 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ý chcete vyhledat v ovládacím prvku.

start

Int32

Umístění v textu ovládacího prvku, ve kterém chcete 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 RichTextBox první instance vyhledávacího řetězce předaného do textového parametru metody. Počáteční umístění hledání je určeno počátečním parametrem metody. Pokud je hledaný řetězec nalezen v RichTextBox, metoda vrátí index umístění 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í, které odpovídají případu zadaného vyhledávacího řetězce. Příklad vyžaduje, aby tato metoda byla umístěna ve třídě Form , která obsahuje pojmenovaný RichTextBoxrichTextBox1. Tento příklad můžete použít k provedení operace Najít další. Jakmile se najde instance hledaného textu, můžete najít další výskyty textu tak, že změníte hodnotu parametru start tak, aby se hledala na jiném místě, než je pozice 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 hledaného řetězce v ovládacím prvku. Pokud vlastnost vrátí zápornou hodnotu, textový řetězec, který hledáte, nebyl nalezen v obsahu ovládacího prvku. Tuto metodu můžete použít k vytvoření funkce vyhledávání, které lze poskytnout uživateli ovládacího prvku. Tuto metodu můžete použít také k vyhledání textu, který se má nahradit 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.

Pomocí této verze Find metody můžete zadat možnosti, které umožňují rozbalit nebo zúžit hledání. Můžete zadat možnosti, které umožňují shodovat velikost textu 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 z dolní části dokumentu na začátek namísto výchozí metody hledání shora dolů. 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 kde konkrétní hledaný text neexistuje. RichTextBoxFinds.Reverse Pokud je hodnota zadána v parametruoptions, hodnota start parametru 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.

Note

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

Find(String, Int32, Int32, RichTextBoxFinds)

Zdroj:

RichTextBox.cs

Vyhledá text v ovládacím RichTextBox prvku řetězec v rozsahu textu v ovládacím 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ý chcete vyhledat v ovládacím prvku.

start

Int32

Umístění v textu ovládacího prvku, ve kterém chcete 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) nebo větší 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ší start než parametr.

Příklady

Následující příklad kódu prohledá část textu v RichTextBox první instanci vyhledávacího řetězce předaného do searchText parametru metody. Rozsah pro hledání textu v rámci ovládacího prvku je určen searchStart parametry searchEnd metody. Pokud je hledaný řetězec nalezen v RichTextBox, metoda vrátí index umístění 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 se měl shodovat s písmeny vyhledávacího řetězce. 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. 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 hledaného řetězce v ovládacím prvku. Pokud vlastnost vrátí zápornou hodnotu, textový řetězec, který hledáte, nebyl nalezen v obsahu ovládacího prvku. Tuto metodu můžete použít k vytvoření funkce vyhledávání, které lze poskytnout uživateli ovládacího prvku. Tuto metodu můžete použít také k vyhledání textu, který se má nahradit 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.

Pomocí této verze Find metody můžete zadat možnosti, které umožňují rozbalit nebo zúžit hledání. Můžete zadat možnosti, které umožňují shodovat velikost textu 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 z dolní části dokumentu na začátek namísto výchozí metody hledání shora dolů. 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 konkrétní část textu ovládacího prvku. Pokud je parametru přiřazena end hodnota záporná (-1), metoda vyhledá až do konce textu v normálním RichTextBox hledání. Při zpětném hledání hodnota záporné hodnoty (-1) přiřazená end parametru označuje, že text bude prohledána od konce textu (dole) do pozice definované parametrem start . start Pokud jsou zadané parametry a end mají stejnou hodnotu, hledá se pro normální hledání celý ovládací prvek. V případě zpětného hledání se prohledá celý ovládací prvek, ale hledání začíná v dolní části dokumentu a hledá se v horní části dokumentu.

Note

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