Bagikan melalui

RichTextBox.Find Metode

  • Referensi

Definisi

Ruang nama:
System.Windows.Forms
Rakitan:
System.Windows.Forms.dll

Mencari teks dalam konten RichTextBox.

Overload

Find(Char[])

Mencari teks RichTextBox kontrol untuk instans pertama karakter dari daftar karakter.
Find(String)

Mencari teks dalam RichTextBox kontrol untuk string.
Find(Char[], Int32)

Mencari teks RichTextBox kontrol, pada titik awal tertentu, untuk instans pertama karakter dari daftar karakter.
Find(String, RichTextBoxFinds)

Mencari teks dalam RichTextBox kontrol untuk string dengan opsi tertentu yang diterapkan pada pencarian.
Find(Char[], Int32, Int32)

Mencari rentang teks dalam RichTextBox kontrol untuk instans pertama karakter dari daftar karakter.
Find(String, Int32, RichTextBoxFinds)

Mencari teks dalam RichTextBox kontrol untuk string di lokasi tertentu dalam kontrol dan dengan opsi tertentu yang diterapkan ke pencarian.
Find(String, Int32, Int32, RichTextBoxFinds)

Mencari teks dalam RichTextBox kontrol untuk string dalam rentang teks dalam kontrol dan dengan opsi tertentu yang diterapkan ke pencarian.

Find(Char[])

Mencari teks RichTextBox kontrol untuk instans pertama karakter dari daftar karakter.

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

Parameter

characterSet
Char[]

Array karakter yang akan dicari.

Mengembalikan

Int32

Lokasi dalam kontrol tempat karakter pencarian ditemukan atau -1 jika karakter pencarian tidak ditemukan atau kumpulan karakter pencarian kosong ditentukan dalam char parameter .

Contoh

Contoh kode berikut mencari konten untuk RichTextBox karakter yang diteruskan ke metode dalam text parameter . Jika konten text array ditemukan dalam RichTextBox, metode mengembalikan indeks nilai yang ditemukan; jika tidak, ia mengembalikan -1. Contohnya mengharuskan metode ini ditempatkan di kelas Form yang berisi RichTextBox kontrol bernama richTextBox1 dan Button kontrol, bernama button1, yang terhubung ke Click penanganan aktivitas yang ditentukan dalam contoh.

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

Keterangan

Versi Find metode ini mencari instans pertama karakter dari daftar karakter yang ditentukan dalam characterSet parameter dan mengembalikan lokasi karakter. Misalnya, Anda meneruskan array karakter yang berisi karakter 'Q'. Jika kontrol berisi teks "The Quick Brown Fox", Find metode akan mengembalikan nilai empat. Karakter huruf besar dan karakter huruf kecil dianggap sebagai nilai yang berbeda dalam pencarian.

Jika properti mengembalikan nilai negatif, karakter yang dicari tidak ditemukan dalam konten kontrol. Anda dapat menggunakan metode ini untuk mencari sekelompok karakter dalam kontrol. Versi Find metode ini mengharuskan seluruh dokumen yang terkandung dalam kontrol dicari untuk karakter. Jika karakter dari daftar karakter yang disediakan dalam parameter metode characterSet ditemukan, nilai yang dikembalikan oleh metode ini adalah indeks berbasis nol dari posisi karakter dalam kontrol. Spasi dianggap sebagai karakter dengan metode saat menentukan lokasi karakter.

Berlaku untuk

Find(String)

Mencari teks dalam RichTextBox kontrol untuk string.

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

Parameter

str
String

Teks yang akan ditemukan dalam kontrol.

Mengembalikan

Int32

Lokasi dalam kontrol tempat teks pencarian ditemukan atau -1 jika string pencarian tidak ditemukan atau string pencarian kosong ditentukan dalam str parameter .

Contoh

Contoh kode berikut mencari seluruh konten untuk RichTextBox instans pertama string pencarian yang diteruskan ke parameter teks metode . Jika string pencarian ditemukan di RichTextBox, metode mengembalikan nilai true dan menyoroti teks pencarian, jika tidak, maka akan mengembalikan false. Contohnya mengharuskan metode ini ditempatkan di kelas yang Form berisi bernama 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

Keterangan

Metode ini Find mencari teks yang ditentukan dalam str parameter dan mengembalikan lokasi karakter pertama dalam kontrol. Jika properti mengembalikan nilai negatif, string teks yang sedang dicari tidak ditemukan dalam konten kontrol. Anda dapat menggunakan metode ini untuk membuat fungsionalitas pencarian yang dapat diberikan kepada pengguna kontrol. Anda juga dapat menggunakan metode ini untuk mencari teks yang akan diganti dengan format tertentu. Misalnya, jika pengguna memasukkan tanggal ke dalam kontrol, Anda dapat menggunakan Find metode untuk mencari semua tanggal dalam dokumen dan menggantinya dengan format yang sesuai sebelum menggunakan SaveFile metode kontrol.

Catatan

Metode Find yang menerima string sebagai parameter tidak dapat menemukan teks yang terkandung pada lebih dari satu baris teks dalam RichTextBox. Melakukan pencarian seperti itu akan mengembalikan nilai negatif satu (-1).

Berlaku untuk

Find(Char[], Int32)

Mencari teks RichTextBox kontrol, pada titik awal tertentu, untuk instans pertama karakter dari daftar karakter.

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

Parameter

characterSet
Char[]

Array karakter yang akan dicari.

start
Int32

Lokasi dalam teks kontrol untuk mulai mencari.

Mengembalikan

Int32

Lokasi dalam kontrol tempat karakter pencarian ditemukan.

Contoh

Contoh kode berikut mencari konten untuk RichTextBox karakter yang diteruskan ke metode dalam text parameter . Pencarian dimulai dari lokasi dalam RichTextBox yang ditentukan oleh start parameter FindMyText metode . Jika konten array teks ditemukan di RichTextBox, metode mengembalikan indeks nilai yang ditemukan; jika tidak, ia mengembalikan -1. Contohnya mengharuskan metode ini ditempatkan di kelas Form yang berisi RichTextBox kontrol bernama richTextBox1 dan Button kontrol bernama button1 yang terhubung ke Click penanganan aktivitas yang ditentukan dalam contoh.

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

Keterangan

Versi Find metode ini mencari instans pertama karakter dari daftar karakter yang ditentukan dalam characterSet parameter dan mengembalikan lokasi karakter. Misalnya, Anda meneruskan array karakter yang berisi karakter 'Q'. Jika kontrol berisi teks "The Quick Brown Fox", Find metode akan mengembalikan nilai empat. Karakter huruf besar dan karakter huruf kecil dianggap sebagai nilai yang berbeda dalam pencarian.

Jika properti mengembalikan nilai negatif, karakter yang dicari tidak ditemukan dalam konten kontrol. Anda dapat menggunakan metode ini untuk mencari sekelompok karakter dalam kontrol. Jika karakter dari daftar karakter yang disediakan dalam parameter metode characterSet ditemukan, nilai yang dikembalikan oleh metode ini adalah indeks berbasis nol dari posisi karakter dalam kontrol. Spasi dianggap sebagai karakter dengan metode saat menentukan lokasi karakter.

Versi Find metode ini memungkinkan Anda mencari kumpulan karakter dari posisi awal yang ditentukan dalam teks kontrol dengan menentukan nilai untuk start parameter . Nilai nol menunjukkan bahwa pencarian harus dimulai dari awal dokumen kontrol. Anda dapat menggunakan versi Find metode ini untuk mempersempit pencarian Anda untuk menghindari teks yang sudah Anda ketahui tidak berisi karakter yang ditentukan yang Anda cari atau tidak penting dalam pencarian Anda.

Berlaku untuk

Find(String, RichTextBoxFinds)

Mencari teks dalam RichTextBox kontrol untuk string dengan opsi tertentu yang diterapkan pada pencarian.

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

Parameter

str
String

Teks yang akan ditemukan dalam kontrol.

options
RichTextBoxFinds

Kombinasi bitwise dari RichTextBoxFinds nilai.

Mengembalikan

Int32

Lokasi dalam kontrol tempat teks pencarian ditemukan.

Contoh

Contoh kode berikut mencari seluruh konten untuk RichTextBox instans pertama string pencarian yang diteruskan ke parameter teks metode . Jika string pencarian ditemukan di RichTextBox, metode mengembalikan nilai true dan menyoroti teks; jika tidak, string pencarian falseakan mengembalikan . Contoh ini juga menentukan opsi dalam pencarian untuk mencocokkan kasus string pencarian yang ditentukan. Contohnya mengharuskan metode ini ditempatkan di kelas yang Form berisi bernama 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

Keterangan

Metode ini Find mencari teks yang ditentukan dalam str parameter dan mengembalikan lokasi karakter pertama dalam kontrol. Jika properti mengembalikan nilai negatif, string teks yang sedang dicari tidak ditemukan dalam konten kontrol. Anda dapat menggunakan metode ini untuk membuat fungsionalitas pencarian yang dapat diberikan kepada pengguna kontrol. Anda juga dapat menggunakan metode ini untuk mencari teks yang akan diganti dengan format tertentu. Misalnya, jika pengguna memasukkan tanggal ke dalam kontrol, Anda dapat menggunakan Find metode untuk mencari semua tanggal dalam dokumen dan menggantinya dengan format yang sesuai sebelum menggunakan SaveFile metode kontrol.

Dengan versi Find metode ini, Anda dapat menentukan opsi yang memungkinkan Anda memperluas atau mempersempit pencarian Anda. Anda dapat menentukan opsi yang memungkinkan Anda untuk mencocokkan casing kata pencarian atau untuk mencari seluruh kata alih-alih kata parsial. Dengan menentukan RichTextBoxFinds.Reverse enumerasi dalam options parameter, Anda dapat mencari teks dari bagian bawah dokumen ke atas alih-alih metode pencarian atas ke bawah default.

Catatan

Metode Find yang menerima string sebagai parameter tidak dapat menemukan teks yang terkandung pada lebih dari satu baris teks dalam RichTextBox. Melakukan pencarian seperti itu akan mengembalikan nilai negatif satu (-1).

Berlaku untuk

Find(Char[], Int32, Int32)

Mencari rentang teks dalam RichTextBox kontrol untuk instans pertama karakter dari daftar karakter.

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

Parameter

characterSet
Char[]

Array karakter yang akan dicari.

start
Int32

Lokasi dalam teks kontrol untuk mulai mencari.

end
Int32

Lokasi dalam teks kontrol untuk mengakhiri pencarian.

Mengembalikan

Int32

Lokasi dalam kontrol tempat karakter pencarian ditemukan.

Pengecualian

ArgumentNullException

characterSet adalah null.

ArgumentException

start kurang dari 0 atau lebih besar dari panjang teks dalam kontrol.

Keterangan

Versi Find metode ini mencari instans pertama karakter dari daftar karakter yang ditentukan dalam characterSet parameter dan mengembalikan lokasi karakter. Misalnya, Anda meneruskan array karakter yang berisi karakter 'Q'. Jika kontrol berisi teks "The Quick Brown Fox", Find metode akan mengembalikan nilai empat. Karakter huruf besar dan karakter huruf kecil dianggap sebagai nilai yang berbeda dalam pencarian.

Jika properti mengembalikan nilai negatif, karakter yang dicari tidak ditemukan dalam konten kontrol. Anda dapat menggunakan metode ini untuk mencari sekelompok karakter dalam kontrol. Jika karakter dari daftar karakter yang disediakan dalam parameter metode characterSet ditemukan, nilai yang dikembalikan oleh metode ini adalah indeks berbasis nol dari posisi karakter dalam kontrol. Spasi dianggap sebagai karakter dengan metode saat menentukan lokasi karakter.

Versi Find metode ini memungkinkan Anda mencari kumpulan karakter dari rentang teks dalam kontrol dengan menentukan nilai untuk start parameter dan end . Nilai nol untuk start parameter menunjukkan bahwa pencarian harus dimulai dari awal dokumen kontrol. Nilai -1 untuk end parameter menunjukkan bahwa pencarian harus berakhir di akhir teks dalam kontrol. Anda dapat menggunakan versi Find metode ini untuk mempersempit pencarian Anda ke rentang teks tertentu dalam kontrol untuk menghindari pencarian area dokumen yang tidak penting untuk kebutuhan aplikasi Anda.

Berlaku untuk

Find(String, Int32, RichTextBoxFinds)

Mencari teks dalam RichTextBox kontrol untuk string di lokasi tertentu dalam kontrol dan dengan opsi tertentu yang diterapkan ke pencarian.

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

Parameter

str
String

Teks yang akan ditemukan dalam kontrol.

start
Int32

Lokasi dalam teks kontrol untuk mulai mencari.

options
RichTextBoxFinds

Kombinasi bitwise dari RichTextBoxFinds nilai.

Mengembalikan

Int32

Lokasi dalam kontrol tempat teks pencarian ditemukan.

Contoh

Contoh kode berikut mencari seluruh konten untuk RichTextBox instans pertama string pencarian yang diteruskan ke parameter teks metode . Lokasi awal pencarian ditentukan oleh parameter awal metode . Jika string pencarian ditemukan di RichTextBox, metode mengembalikan lokasi indeks karakter pertama dari teks yang ditemukan dan menyoroti teks yang ditemukan; jika tidak, ia mengembalikan nilai -1. Contoh ini juga menentukan opsi dalam pencarian untuk mencocokkan kasus string pencarian yang ditentukan. Contohnya mengharuskan metode ini ditempatkan di kelas yang Form berisi bernama RichTextBoxrichTextBox1. Anda dapat menggunakan contoh ini untuk melakukan jenis operasi "Temukan Berikutnya". Setelah instans teks pencarian ditemukan, Anda dapat menemukan instans teks lain dengan mengubah nilai start parameter untuk mencari di lokasi di luar posisi kecocokan saat ini.

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

Keterangan

Metode mencari Find teks yang ditentukan dalam str parameter dan mengembalikan lokasi karakter pertama string pencarian dalam kontrol. Jika properti mengembalikan nilai negatif, string teks yang sedang dicari tidak ditemukan dalam konten kontrol. Anda dapat menggunakan metode ini untuk membuat fungsionalitas pencarian yang dapat diberikan kepada pengguna kontrol. Anda juga dapat menggunakan metode ini untuk mencari teks yang akan diganti dengan format tertentu. Misalnya, jika pengguna memasukkan tanggal ke dalam kontrol, Anda dapat menggunakan Find metode untuk mencari semua tanggal dalam dokumen dan menggantinya dengan format yang sesuai sebelum menggunakan SaveFile metode kontrol.

Dengan versi Find metode ini, Anda dapat menentukan opsi yang memungkinkan Anda memperluas atau mempersempit pencarian Anda. Anda dapat menentukan opsi yang memungkinkan Anda untuk mencocokkan casing kata pencarian atau untuk mencari seluruh kata alih-alih kata parsial. Dengan menentukan RichTextBoxFinds.Reverse enumerasi dalam options parameter, Anda dapat mencari teks dari bagian bawah dokumen ke atas alih-alih metode pencarian atas ke bawah default. Versi Find metode ini juga memungkinkan Anda mempersempit pencarian teks dengan memilih posisi awal tertentu dalam teks kontrol. Fitur ini dapat memungkinkan Anda untuk menghindari teks yang mungkin telah dicari atau di mana teks tertentu yang Anda cari diketahui tidak ada. RichTextBoxFinds.Reverse Ketika nilai ditentukan dalam options parameter, nilai start parameter menunjukkan posisi di mana pencarian terbalik akan berakhir karena pencarian akan dimulai di bagian bawah dokumen saat menggunakan versi Find metode ini.

Catatan

Metode Find yang menerima string sebagai parameter tidak dapat menemukan teks yang terkandung pada lebih dari satu baris teks dalam RichTextBox. Melakukan pencarian seperti itu akan mengembalikan nilai negatif satu (-1).

Berlaku untuk

Find(String, Int32, Int32, RichTextBoxFinds)

Mencari teks dalam RichTextBox kontrol untuk string dalam rentang teks dalam kontrol dan dengan opsi tertentu yang diterapkan ke pencarian.

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

Parameter

str
String

Teks yang akan ditemukan dalam kontrol.

start
Int32

Lokasi dalam teks kontrol untuk mulai mencari.

end
Int32

Lokasi dalam teks kontrol untuk mengakhiri pencarian. Nilai ini harus sama dengan negatif satu (-1) atau lebih besar dari atau sama dengan start parameter.

options
RichTextBoxFinds

Kombinasi bitwise dari RichTextBoxFinds nilai.

Mengembalikan

Int32

Lokasi dalam kontrol tempat teks pencarian ditemukan.

Pengecualian

ArgumentNullException

Parameternya str adalah null.

ArgumentException

Parameternya start kurang dari nol.

-atau-

Parameternya end kurang parameternya start .

Contoh

Contoh kode berikut mencari bagian teks dalam RichTextBox untuk instans pertama string pencarian yang diteruskan ke searchText parameter metode . Rentang untuk mencari teks dalam kontrol ditentukan oleh searchStart parameter dan searchEnd metode . Jika string pencarian ditemukan di RichTextBox, metode mengembalikan lokasi indeks karakter pertama dari teks yang ditemukan dan menyoroti teks yang ditemukan; jika tidak, ia mengembalikan nilai -1. Contoh ini juga menggunakan options parameter Find metode untuk menentukan bahwa teks yang ditemukan harus cocok dengan kasus string pencarian. Contohnya mengharuskan metode ini ditempatkan di kelas yang Form berisi RichTextBox kontrol bernama richTextBox1. Setelah instans pertama string pencarian ditemukan, Anda dapat menggunakan contoh ini untuk menemukan instans lain dalam teks.

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

Keterangan

Metode mencari Find teks yang ditentukan dalam str parameter dan mengembalikan lokasi karakter pertama string pencarian dalam kontrol. Jika properti mengembalikan nilai negatif, string teks yang sedang dicari tidak ditemukan dalam konten kontrol. Anda dapat menggunakan metode ini untuk membuat fungsionalitas pencarian yang dapat diberikan kepada pengguna kontrol. Anda juga dapat menggunakan metode ini untuk mencari teks yang akan diganti dengan format tertentu. Misalnya, jika pengguna memasukkan tanggal ke dalam kontrol, Anda dapat menggunakan Find metode untuk mencari semua tanggal dalam dokumen dan menggantinya dengan format yang sesuai sebelum menggunakan SaveFile metode kontrol.

Dengan versi Find metode ini, Anda dapat menentukan opsi yang memungkinkan Anda memperluas atau mempersempit pencarian Anda. Anda dapat menentukan opsi yang memungkinkan Anda untuk mencocokkan casing kata pencarian atau untuk mencari seluruh kata alih-alih kata parsial. Dengan menentukan RichTextBoxFinds.Reverse enumerasi dalam options parameter, Anda dapat mencari teks dari bagian bawah dokumen ke atas alih-alih metode pencarian atas ke bawah default. Versi Find metode ini juga memungkinkan Anda mempersempit pencarian teks dengan memilih posisi awal dan akhir tertentu dalam teks kontrol. Fitur ini dapat memungkinkan Anda membatasi rentang pencarian ke bagian tertentu dari teks kontrol. Jika nilai negatif satu (-1) ditetapkan ke end parameter, metode akan mencari hingga akhir teks dalam RichTextBox untuk pencarian normal. Untuk pencarian terbalik, nilai negatif satu (-1) yang ditetapkan ke end parameter menunjukkan bahwa teks akan dicari dari akhir teks (bawah) ke posisi yang ditentukan oleh start parameter. start Ketika parameter dan end disediakan nilai yang sama, seluruh kontrol dicari untuk pencarian normal. Untuk pencarian terbalik, seluruh kontrol dicari tetapi pencarian dimulai di bagian bawah dokumen dan mencari di bagian atas dokumen.

Catatan

Metode Find yang menerima string sebagai parameter tidak dapat menemukan teks yang terkandung pada lebih dari satu baris teks dalam RichTextBox. Melakukan pencarian seperti itu akan mengembalikan nilai negatif satu (-1).

Berlaku untuk