RichTextBox.Find Yöntem

Tanım

Ad Alanı:: System.Windows.Forms

Bütünleştirilmiş Kod:: System.Windows.Forms.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

içindeki RichTextBoxmetinleri arar.

Aşırı Yüklemeler

Name	Description
Find(Char[])	Bir karakter listesinden RichTextBox bir karakterin ilk örneği için denetimin metninde aramalar.
Find(String)	Denetimdeki metinde RichTextBox dize arar.
Find(Char[], Int32)	Belirli bir başlangıç noktasında, bir RichTextBox karakter listesinden bir karakterin ilk örneği için denetimin metnini arar.
Find(String, RichTextBoxFinds)	Denetimdeki metinde RichTextBox , aramaya belirli seçeneklerin uygulandığı bir dize arar.
Find(Char[], Int32, Int32)	Bir karakter listesinden bir karakterin ilk örneği için denetimdeki bir metin RichTextBox aralığını arar.
Find(String, Int32, RichTextBoxFinds)	Denetimdeki metinde RichTextBox , denetimin içinde belirli bir konumdaki bir dizeyi arar ve aramaya belirli seçenekler uygulanır.
Find(String, Int32, Int32, RichTextBoxFinds)	Denetimdeki metinde RichTextBox , denetim içindeki bir metin aralığındaki bir dizeyi arar ve aramaya belirli seçenekler uygulanır.

Find(Char[])

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Bir karakter listesinden RichTextBox bir karakterin ilk örneği için denetimin metninde aramalar.

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

Parametreler

characterSet: Char[]

Aranacak karakter dizisi.

Döndürülenler

Int32

Arama karakterlerinin bulunduğu denetim içindeki konum veya arama karakterleri bulunamazsa veya parametrede char boş bir arama karakter kümesi belirtilirse -1.

Örnekler

Aşağıdaki kod örneği, parametresindeki yöntemine RichTextBox geçirilen karakterlerin içeriğini text arar. Dizinin içeriği text içinde RichTextBoxbulunursa, yöntemi bulunan değerin dizinini döndürür; aksi takdirde -1 döndürür. Örnek, bu yöntemin, adında bir Form denetim ve adlı, örnekte tanımlanan olay işleyicisine bağlı olan bir RichTextBox denetimi richTextBox1içeren sınıfına Buttonbutton1 yerleştirilmesini Click gerektirir.

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

Açıklamalar

Yöntemin Find bu sürümü, parametresinde characterSet belirtilen karakter listesinden bir karakterin ilk örneğini arar ve karakterin konumunu döndürür. Örneğin, 'Q' karakterini içeren bir karakter dizisi geçirirsiniz. Denetim "Hızlı Kahverengi Tilki" metnini içeriyorsa, Find yöntem dört değerini döndürür. Büyük harf karakteri ve küçük harf karakteri aramada farklı değerler olarak kabul edilir.

özelliği negatif bir değer döndürürse, aranmakta olan karakterler denetimin içeriğinde bulunamadı. Denetimin içindeki bir karakter grubunu aramak için bu yöntemi kullanabilirsiniz. Yöntemin Find bu sürümü, denetimde yer alan belgenin tamamında karakterler için arama yapılmasını gerektirir. Yöntemin characterSet parametresinde sağlanan karakter listesinden bir karakter bulunursa, bu yöntem tarafından döndürülen değer, karakterin denetimdeki konumunun sıfır tabanlı bir dizinidir. Boşluk, bir karakterin konumunu belirlerken yöntemi tarafından bir karakter olarak kabul edilir.

Şunlara uygulanır

Find(String)

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Denetimdeki metinde RichTextBox dize arar.

public:
 int Find(System::String ^ str);

public int Find(string str);

member this.Find : string -> int

Public Function Find (str As String) As Integer

Parametreler

str: String

Denetimde bulunacak metin.

Döndürülenler

Int32

Denetimde arama metninin bulunduğu konum veya arama dizesi bulunamazsa veya parametresinde str boş bir arama dizesi belirtilirse -1.

Örnekler

Aşağıdaki kod örneği, yönteminin RichTextBox text parametresine geçirilen bir arama dizesinin ilk örneğini tüm içeriğinde arar. Arama dizesi içinde RichTextBoxbulunursa yöntemi değerini döndürür true ve arama metnini vurgular, aksi takdirde döndürür false. Örnek, bu yöntemin adlı Formöğesini RichTextBox içeren bir richTextBox1 sınıfına yerleştirilmesini gerektirir.

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

Açıklamalar

yöntemi, Find parametresinde str belirtilen metni arar ve denetimdeki ilk karakterin konumunu döndürür. özelliği negatif bir değer döndürürse, aranmakta olan metin dizesi denetimin içeriğinde bulunamadı. Denetimin kullanıcısına sağlanabilir arama işlevselliği oluşturmak için bu yöntemi kullanabilirsiniz. Belirli bir biçimle değiştirilecek metni aramak için de bu yöntemi kullanabilirsiniz. Örneğin, kullanıcı denetime tarih girdiyse, denetimin Find yöntemini kullanmadan SaveFile önce belgedeki tüm tarihleri aramak ve bunları uygun biçimle değiştirmek için yöntemini kullanabilirsiniz.

Note

Find parametresini parametre olarak kabul string eden yöntemler içinde birden fazla metin satırında bulunan metni RichTextBoxbulamıyor. Böyle bir arama yapmak negatif bir değer döndürür (-1).

Şunlara uygulanır

Find(Char[], Int32)

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Belirli bir başlangıç noktasında, bir RichTextBox karakter listesinden bir karakterin ilk örneği için denetimin metnini arar.

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

Parametreler

characterSet: Char[]

Aranacak karakter dizisi.

start: Int32

Denetimin metni içinde aramaya başlanması gereken konum.

Döndürülenler

Int32

Denetimdeki arama karakterlerinin bulunduğu konum.

Örnekler

Aşağıdaki kod örneği, parametresindeki yöntemine RichTextBox geçirilen karakterlerin içeriğini text arar. Arama, yönteminin parametresi tarafından RichTextBox belirtilen konumundan startFindMyText başlar. Metin dizisinin içeriği içinde RichTextBoxbulunursa, yöntemi bulunan değerin dizinini döndürür; aksi takdirde -1 döndürür. Örnek, bu yöntemin adlı bir denetimi ve örnekte tanımlanan olay işleyicisine Form bağlı olan adlı RichTextBox bir richTextBox1 denetimi içeren bir sınıfına Button yerleştirilmesini gerektirir.button1Click

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

Açıklamalar

özelliği negatif bir değer döndürürse, aranmakta olan karakterler denetimin içeriğinde bulunamadı. Denetimin içindeki bir karakter grubunu aramak için bu yöntemi kullanabilirsiniz. Yöntemin characterSet parametresinde sağlanan karakter listesinden bir karakter bulunursa, bu yöntem tarafından döndürülen değer, karakterin denetimdeki konumunun sıfır tabanlı bir dizinidir. Boşluk, bir karakterin konumunu belirlerken yöntemi tarafından bir karakter olarak kabul edilir.

Yönteminin Find bu sürümü, parametre için bir değer start belirterek denetimin metni içinde belirtilen başlangıç konumundan bir karakter kümesi aramanızı sağlar. Sıfır değeri, aramanın denetimin belgesinin başından başlaması gerektiğini gösterir. Aradığınız veya aramanızda önemli olmayan belirtilen karakterleri içermediğini bildiğiniz metinlerden kaçınmak için aramanızı daraltmak için yönteminin bu sürümünü Find kullanabilirsiniz.

Şunlara uygulanır

Find(String, RichTextBoxFinds)

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Denetimdeki metinde RichTextBox , aramaya belirli seçeneklerin uygulandığı bir dize arar.

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

Parametreler

str: String

Denetimde bulunacak metin.

options: RichTextBoxFinds

Değerlerin bit düzeyinde birleşimi RichTextBoxFinds .

Döndürülenler

Int32

Denetim içindeki arama metninin bulunduğu konum.

Örnekler

Aşağıdaki kod örneği, yönteminin RichTextBox text parametresine geçirilen bir arama dizesinin ilk örneğini tüm içeriğinde arar. Arama dizesi içinde RichTextBoxbulunursa, yöntemi değerini true döndürür ve metni vurgular; aksi takdirde döndürür false. Örnek, belirtilen arama dizesinin büyük/küçük harfle eşleşmesi için aramadaki seçenekleri de belirtir. Örnek, bu yöntemin adlı Formöğesini RichTextBox içeren bir richTextBox1 sınıfına yerleştirilmesini gerektirir.

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

Açıklamalar

Note

Şunlara uygulanır

Find(Char[], Int32, Int32)

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Bir karakter listesinden bir karakterin ilk örneği için denetimdeki bir metin RichTextBox aralığını arar.

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

Parametreler

characterSet: Char[]

Aranacak karakter dizisi.

start: Int32

Denetimin metni içinde aramaya başlanması gereken konum.

end: Int32

Denetimin metni içinde aramayı sonlandıracak konum.

Döndürülenler

Int32

Denetimdeki arama karakterlerinin bulunduğu konum.

Özel durumlar

ArgumentNullException

characterSet null değeridir.

ArgumentException

start , denetimdeki metnin uzunluğundan 0'dan küçük veya daha büyük.

Açıklamalar

özelliği negatif bir değer döndürürse, aranmakta olan karakterler denetimin içeriğinde bulunamadı. Denetimin içindeki bir karakter grubunu aramak için bu yöntemi kullanabilirsiniz. Yöntemin characterSet parametresinde sağlanan karakter listesinden bir karakter bulunursa, bu yöntem tarafından döndürülen değer, karakterin denetimdeki konumunun sıfır tabanlı dizinidir. Boşluk, bir karakterin konumunu belirlerken yöntemi tarafından bir karakter olarak kabul edilir.

yönteminin Find bu sürümü, ve start parametreleri için bir değer belirterek denetimdeki bir metin aralığından end karakter kümesi aramanızı sağlar. parametresi için start sıfır değeri, aramanın denetimin belgesinin başından başlaması gerektiğini gösterir. parametresi için end -1 değeri, aramanın denetim içindeki metnin sonunda bitmesi gerektiğini gösterir. Belgenin Find uygulamanızın gereksinimleri açısından önemli olmayan alanlarda arama yapmaktan kaçınmak için, aramanızı denetim içindeki belirli bir metin aralığına daraltmak için yönteminin bu sürümünü kullanabilirsiniz.

Şunlara uygulanır

Find(String, Int32, RichTextBoxFinds)

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Denetimdeki metinde RichTextBox , denetimin içinde belirli bir konumdaki bir dizeyi arar ve aramaya belirli seçenekler uygulanır.

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

Parametreler

str: String

Denetimde bulunacak metin.

start: Int32

Denetimin metni içinde aramaya başlanması gereken konum.

options: RichTextBoxFinds

Değerlerin bit düzeyinde birleşimi RichTextBoxFinds .

Döndürülenler

Int32

Denetim içindeki arama metninin bulunduğu konum.

Örnekler

Aşağıdaki kod örneği, yönteminin RichTextBox text parametresine geçirilen bir arama dizesinin ilk örneğini tüm içeriğinde arar. Arama başlangıç konumu, yönteminin start parametresi tarafından belirtilir. Arama dizesi içinde RichTextBoxbulunursa yöntemi, bulunan metnin ilk karakterinin dizin konumunu döndürür ve bulunan metni vurgular; aksi takdirde -1 değerini döndürür. Örnek, belirtilen arama dizesinin büyük/küçük harfle eşleşmesi için aramadaki seçenekleri de belirtir. Örnek, bu yöntemin adlı Formöğesini RichTextBox içeren bir richTextBox1 sınıfına yerleştirilmesini gerektirir. "Sonrakini Bul" türünde bir işlem gerçekleştirmek için bu örneği kullanabilirsiniz. Arama metninin bir örneği bulunduktan sonra, geçerli eşleşmenin konumunun ötesinde bir konumda arama yapmak için parametrenin start değerini değiştirerek metnin diğer örneklerini bulabilirsiniz.

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

Açıklamalar

yöntemi, Find parametresinde str belirtilen metni arar ve denetim içindeki arama dizesinin ilk karakterinin konumunu döndürür. özelliği negatif bir değer döndürürse, aranmakta olan metin dizesi denetimin içeriğinde bulunamadı. Denetimin kullanıcısına sağlanabilir arama işlevselliği oluşturmak için bu yöntemi kullanabilirsiniz. Belirli bir biçimle değiştirilecek metni aramak için de bu yöntemi kullanabilirsiniz. Örneğin, kullanıcı denetime tarih girdiyse, denetimin Find yöntemini kullanmadan SaveFile önce belgedeki tüm tarihleri aramak ve bunları uygun biçimle değiştirmek için yöntemini kullanabilirsiniz.

Yöntemin Find bu sürümüyle, aramanızı genişletmenizi veya daraltmanızı sağlayan seçenekleri belirtebilirsiniz. Arama sözcüğünün büyük/küçük harfle eşleşmesini veya kısmi sözcükler yerine sözcüklerin tamamını aramanızı sağlayan seçenekler belirtebilirsiniz. parametresinde RichTextBoxFinds.Reverse numaralandırmayı options belirterek, varsayılan üstten alta arama yöntemi yerine belgenin alt kısmından en üste kadar metin arayabilirsiniz. Yöntemin bu sürümü, denetimin Find metni içinde belirli bir başlangıç konumunu seçerek metin aramasını daraltmanızı da sağlar. Bu özellik, zaten aranmış olabilecek veya aradığınız metnin mevcut olmadığı bilinen metinlerden kaçınmanızı sağlayabilir. RichTextBoxFinds.Reverse değer parametresinde belirtildiğindeoptions, parametrenin start değeri, yöntemin bu sürümünü Find kullanırken arama belgenin en altında başlayacağından ters aramanın sona ereceği konumu gösterir.

Note

Şunlara uygulanır

Find(String, Int32, Int32, RichTextBoxFinds)

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Kaynak:: RichTextBox.cs

Denetimdeki metinde RichTextBox , denetim içindeki bir metin aralığındaki bir dizeyi arar ve aramaya belirli seçenekler uygulanır.

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

Parametreler

str: String

Denetimde bulunacak metin.

start: Int32

Denetimin metni içinde aramaya başlanması gereken konum.

end: Int32

Denetimin metni içinde aramayı sonlandıracak konum. Bu değer negatif değere eşit (-1) veya parametresinden büyük veya buna eşit start olmalıdır.

options: RichTextBoxFinds

Değerlerin bit düzeyinde birleşimi RichTextBoxFinds .

Döndürülenler

Int32

Denetim içindeki arama metninin bulunduğu konum.

Özel durumlar

ArgumentNullException

str parametresiydinull.

ArgumentException

start Parametresi sıfırdan küçüktür.

-veya-

end parametresi daha azdıstart.

Örnekler

Aşağıdaki kod örneği, yönteminin parametresine RichTextBox geçirilen bir arama dizesinin ilk örneğini bir metin searchText bölümünde arar. Denetim içindeki metin için aranacak aralık, yönteminin searchStart ve searchEnd parametreleri tarafından belirtilir. Arama dizesi içinde RichTextBoxbulunursa yöntemi, bulunan metnin ilk karakterinin dizin konumunu döndürür ve bulunan metni vurgular; aksi takdirde -1 değerini döndürür. Örnek, bulunan metnin arama dizesinin büyük/küçük harfle eşleşmesi gerektiğini belirtmek için yönteminin parametresini options de kullanırFind. Örnek, bu yöntemin adlı Formbir denetimi içeren bir RichTextBoxrichTextBox1 sınıfına yerleştirilmesini gerektirir. Arama dizesinin ilk örneği bulunduktan sonra, metindeki diğer örnekleri bulmak için bu örneği kullanabilirsiniz.

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

Açıklamalar

Yöntemin Find bu sürümüyle, aramanızı genişletmenizi veya daraltmanızı sağlayan seçenekleri belirtebilirsiniz. Arama sözcüğünün büyük/küçük harfle eşleşmesini veya kısmi sözcükler yerine sözcüklerin tamamını aramanızı sağlayan seçenekler belirtebilirsiniz. parametresinde RichTextBoxFinds.Reverse numaralandırmayı options belirterek, varsayılan üstten alta arama yöntemi yerine belgenin alt kısmından en üste kadar metin arayabilirsiniz. Yöntemin bu sürümü, denetimin Find metni içinde belirli bir başlangıç ve bitiş konumunu seçerek metin aramasını daraltmanızı da sağlar. Bu özellik, arama aralığını denetimin metninin belirli bir bölümüyle sınırlamanıza olanak sağlayabilir. parametresine negatif bir (-1) değeri atanırsa end , yöntem normal aramalarda RichTextBox metnin sonuna kadar arama yapacaktır. Ters aramalar için, parametreye end atanmış negatif bir (-1) değeri, metnin sonundan (altta) parametre tarafından start tanımlanan konuma kadar aranacağını gösterir. start ve end parametreleri aynı değer sağlandığında, denetimin tamamı normal aramalar için aranılır. Ters arama için denetimin tamamı aranıyor, ancak arama belgenin alt kısmından başlıyor ve belgenin en üstüne doğru aranıyor.

Note

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?