Aracılığıyla paylaş

RichTextBox.Find Yöntem

  • Başvuru

Tanım

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

içindeki RichTextBoxmetinleri arar.

Aşırı Yüklemeler

Find(Char[])

Bir karakter listesinden RichTextBox bir karakterin ilk örneğini bulmak için denetimin metninde arama sağlar.
Find(String)

Denetimdeki metinde RichTextBox dize arar.
Find(Char[], Int32)

Belirli bir başlangıç noktasındaki bir RichTextBox denetimin metninde, karakter listesinden bir karakterin ilk örneğini arar.
Find(String, RichTextBoxFinds)

Denetimdeki metinde RichTextBox , aramaya belirli seçeneklerin uygulandığı bir dize arar.
Find(Char[], Int32, Int32)

Bir karakter listesinden RichTextBox bir karakterin ilk örneğini bulmak için denetimdeki metin aralığını arar.
Find(String, Int32, RichTextBoxFinds)

Denetimdeki metinde RichTextBox denetim 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[])

Bir karakter listesinden RichTextBox bir karakterin ilk örneğini bulmak için denetimin metninde arama sağlar.

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

Denetim içinde arama karakterlerinin bulunduğu 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 text geçirilen karakterlerin içeriğini RichTextBox 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, adlı bir RichTextBox denetim richTextBox1 ve adlı, örnekte tanımlanan olay işleyicisine bağlı bir Button denetim button1içeren sınıfına FormClick yerleştirilmesini 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 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ı. Denetim içindeki bir karakter grubunu aramak için bu yöntemi kullanabilirsiniz. Yöntemin Find bu sürümü, denetimde yer alan belgenin tamamının karakter araması 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)

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

Denetim içinde arama metninin bulunduğu konum veya arama dizesi bulunamazsa veya parametrede 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 bulmak için içindekilerin tamamında arama yapar. 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ı richTextBox1öğesini içeren RichTextBox bir Form 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, yöntemini kullanarak Find belgedeki tüm tarihleri arayabilir ve denetimin yöntemini kullanmadan SaveFile önce bunları uygun biçimle değiştirebilirsiniz.

Not

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

Şunlara uygulanır

Find(Char[], Int32)

Belirli bir başlangıç noktasındaki bir RichTextBox denetimin metninde, karakter listesinden bir karakterin ilk örneğini 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

Denetim içindeki arama karakterlerinin bulunduğu konum.

Örnekler

Aşağıdaki kod örneği, parametresindeki yöntemine text geçirilen karakterlerin içeriğini RichTextBox arar. Arama, yönteminin parametresi tarafından start belirtilen konumundan RichTextBoxFindMyText 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ı richTextBox1 bir RichTextBox denetimi ve örnekte tanımlanan olay işleyicisine Click bağlı adlı button1 bir denetimi içeren sınıfına Button yerleştirilmesini Form gerektirir.

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

Yöntemin Find bu sürümü, parametresinde characterSet belirtilen karakter listesinden 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ı. Denetim 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öntemin 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 karakterleri içermediğini veya aramanızda önemli olmadığını 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)

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 bulmak için içindekilerin tamamında arama yapar. arama dizesi içinde RichTextBoxbulunursa yöntemi değerini döndürür true ve metni vurgular; aksi takdirde döndürür false. Örnek ayrıca aramadaki belirtilen arama dizesinin büyük/küçük harfleriyle eşleşecek seçenekleri de belirtir. Örnek, bu yöntemin adlı richTextBox1öğesini içeren RichTextBox bir Form 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

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, yöntemini kullanarak Find belgedeki tüm tarihleri arayabilir ve denetimin yöntemini kullanmadan SaveFile önce bunları uygun biçimle değiştirebilirsiniz.

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 harflerini eşleştirmenizi veya kısmi sözcükler yerine sözcüklerin tamamını aramanızı sağlayan seçenekleri belirtebilirsiniz. parametresinde options numaralandırmayı RichTextBoxFinds.Reverse belirterek, varsayılan yukarıdan aşağıya arama yöntemi yerine belgenin alt kısmından en üste kadar metin arayabilirsiniz.

Not

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

Şunlara uygulanır

Find(Char[], Int32, Int32)

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

Denetim içinde arama karakterlerinin bulunduğu konum.

Özel durumlar

ArgumentNullException

characterSet null değeridir.

ArgumentException

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

Açıklamalar

Yöntemin Find bu sürümü, parametresinde characterSet belirtilen karakter listesinden 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ı. Denetim 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ü, ve end parametreleri için bir değer belirterek denetimdeki bir metin aralığından start 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 için ö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)

Denetimdeki metinde denetim içinde RichTextBox 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çinde 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 içeren içeriğin tamamında arama yapar. Arama başlangıç konumu, yönteminin başlangıç 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 ayrıca belirtilen arama dizesinin büyük/küçük harfle eşleşmesi için arama seçeneklerini belirtir. Örnek, bu yöntemin adlı richTextBox1öğesini içeren RichTextBox sınıfına Form yerleştirilmesini gerektirir. "Sonrakini Bul" işlem türünü gerçekleştirmek için bu örneği kullanabilirsiniz. Arama metninin bir örneği bulunduktan sonra, geçerli eşleşmenin konumunu aşan bir konumda arama yapmak için parametresinin 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

Find yöntemi, parametresinde str belirtilen metni arar ve arama dizesinin denetim içindeki 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çenekleri belirtebilirsiniz. parametresinde options numaralandırmayı RichTextBoxFinds.Reverse belirterek, varsayılan yukarıdan aşağıya 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ıç konumu seçerek metin aramasını daraltmanıza da olanak tanır. 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.

Not

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

Şunlara 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.

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 bire (-1) eşit 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çinde arama metninin bulunduğu konum.

Özel durumlar

ArgumentNullException

str parametresiydinull.

ArgumentException

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

-veya-

end parametresi daha az start parametreydi.

Örnekler

Aşağıdaki kod örneği, yönteminin parametresine geçirilen searchText bir arama dizesinin ilk örneğini içeren bir metin RichTextBox bölümünde arama yapar. Denetim içindeki metin için arama aralığı, 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. Örnekte ayrıca options bulunan metnin arama dizesinin Find büyük/küçük harfle eşleşmesi gerektiğini belirtmek için yönteminin parametresi kullanılır. Örnek, bu yöntemin adlı richTextBox1denetimi RichTextBox içeren bir Form 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

Find yöntemi, parametresinde str belirtilen metni arar ve arama dizesinin denetim içindeki 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çenekleri belirtebilirsiniz. parametresinde options numaralandırmayı RichTextBoxFinds.Reverse belirterek, varsayılan yukarıdan aşağıya 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ıza da olanak tanır. Bu özellik, arama aralığını denetimin metninin belirli bir bölümüyle sınırlamanızı sağlayabilir. parametresine negatif bir (-1) değeri atanırsa end , yöntem normal aramalar RichTextBox için içindeki metnin sonuna kadar arama yapacaktır. Ters aramalar için parametresine end atanmış negatif bir (-1) değeri, metnin sonundan (altta) parametresi 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 arama yapılır. Ters arama için denetimin tamamında arama yapılır, ancak arama belgenin en altında başlar ve belgenin en üstünde arar.

Not

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

Şunlara uygulanır