ListView.FindItemWithText Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Menemukan yang pertama ListViewItem dengan yang dimulai dengan nilai teks yang diberikan.

Overload

FindItemWithText(String)	Menemukan yang pertama ListViewItem dimulai dengan nilai teks yang ditentukan.
FindItemWithText(String, Boolean, Int32)	Menemukan yang pertama ListViewItem atau ListViewItem.ListViewSubItem, jika ditunjukkan, yang dimulai dengan nilai teks yang ditentukan. Pencarian dimulai pada indeks yang ditentukan.
FindItemWithText(String, Boolean, Int32, Boolean)	Menemukan yang pertama ListViewItem atau ListViewItem.ListViewSubItem, jika ditunjukkan, yang dimulai dengan nilai teks yang ditentukan. Pencarian dimulai pada indeks yang ditentukan.

FindItemWithText(String)

Menemukan yang pertama ListViewItem dimulai dengan nilai teks yang ditentukan.

public:
 System::Windows::Forms::ListViewItem ^ FindItemWithText(System::String ^ text);

public System.Windows.Forms.ListViewItem? FindItemWithText (string text);

member this.FindItemWithText : string -> System.Windows.Forms.ListViewItem

Public Function FindItemWithText (text As String) As ListViewItem

Parameter

text

String

Teks yang akan dicari.

Mengembalikan

ListViewItem

Yang pertama ListViewItem dimulai dengan nilai teks yang ditentukan.

Contoh

Contoh kode berikut menunjukkan FindItemWithText metode . Untuk menjalankan contoh ini, tempelkan kode berikut ke dalam Formulir Windows dan panggil InitializeFindListView metode dari konstruktor formulir atau Load penanganan aktivitas. Klik tombol untuk melihat hasil panggilan metode.

// Declare the ListView and Button for the example.
ListView findListView = new ListView();
Button findButton = new Button();

private void InitializeFindListView()
{
// Set up the location and event handling for the button.
    findButton.Click += new EventHandler(findButton_Click);
    findButton.Location = new Point(10, 10);
    
// Set up the location of the ListView and add some items.
findListView.Location = new Point(10, 30);
    findListView.Items.Add(new ListViewItem("angle bracket"));
    findListView.Items.Add(new ListViewItem("bracket holder"));
    findListView.Items.Add(new ListViewItem("bracket"));

    // Add the button and ListView to the form.
    this.Controls.Add(findButton);
    this.Controls.Add(findListView);
}

void findButton_Click(object sender, EventArgs e)
{
        // Call FindItemWithText, sending output to MessageBox.
    ListViewItem item1 = findListView.FindItemWithText("brack");
     if (item1 != null)
         MessageBox.Show("Calling FindItemWithText passing 'brack': " 
             + item1.ToString());
     else
         MessageBox.Show("Calling FindItemWithText passing 'brack': null");
 }

' Declare the ListView and Button for the example.
Private findListView As New ListView()
Private WithEvents findButton As New Button()


Private Sub InitializeFindListView()

    ' Set up the location and event handling for the button.
    findButton.Location = New Point(10, 10)

    ' Set up the location of the ListView and add some items.
    findListView.Location = New Point(10, 30)
    findListView.Items.Add(New ListViewItem("angle bracket"))
    findListView.Items.Add(New ListViewItem("bracket holder"))
    findListView.Items.Add(New ListViewItem("bracket"))

    ' Add the button and ListView to the form.
    Me.Controls.Add(findButton)
    Me.Controls.Add(findListView)

End Sub

Private Sub findButton_Click(ByVal sender As Object, ByVal e As EventArgs) _
    Handles findButton.Click

    ' Call FindItemWithText, sending output to MessageBox.
    Dim item1 As ListViewItem = findListView.FindItemWithText("brack")
    If (item1 IsNot Nothing) Then
        MessageBox.Show("Calling FindItemWithText passing 'brack': " _
            & item1.ToString())
    Else
        MessageBox.Show("Calling FindItemWithText passing 'brack': null")
    End If

End Sub

Keterangan

Pencarian tidak peka huruf besar/kecil.

Parameter text dapat menentukan substring dari teks pencocokan yang diinginkan. Selain itu, metode ini akan mengembalikan item pertama yang dimulai dengan teks yang ditentukan. Misalnya, jika berisi ListView dua item daftar - teks item pertama diatur ke "kurung sudut" dan teks item kedua diatur ke "tanda kurung" - panggilan untuk FindItemWithText meneruskan brack karena parameter akan mengembalikan item yang teksnya adalah "tanda kurung".

Metode FindItemWithText mengembalikan null jika daftar kosong atau tidak ada item yang cocok.

FindItemWithText(String, Boolean, Int32)

Menemukan yang pertama ListViewItem atau ListViewItem.ListViewSubItem, jika ditunjukkan, yang dimulai dengan nilai teks yang ditentukan. Pencarian dimulai pada indeks yang ditentukan.

public:
 System::Windows::Forms::ListViewItem ^ FindItemWithText(System::String ^ text, bool includeSubItemsInSearch, int startIndex);

public System.Windows.Forms.ListViewItem? FindItemWithText (string text, bool includeSubItemsInSearch, int startIndex);

member this.FindItemWithText : string * bool * int -> System.Windows.Forms.ListViewItem

Public Function FindItemWithText (text As String, includeSubItemsInSearch As Boolean, startIndex As Integer) As ListViewItem

Parameter

text

String

Teks yang akan dicari.

includeSubItemsInSearch

Boolean

true untuk menyertakan subitem dalam pencarian; jika tidak, false.

startIndex

Int32

Indeks item untuk memulai pencarian.

Mengembalikan

ListViewItem

Yang pertama ListViewItem dimulai dengan nilai teks yang ditentukan.

Pengecualian

ArgumentOutOfRangeException

startIndex kurang dari 0 atau lebih dari item angka di ListView.

Keterangan

Pencarian tidak peka huruf besar/kecil.

Parameter text dapat menentukan substring dari teks pencocokan yang diinginkan. Selain itu, metode ini akan mengembalikan item pertama yang dimulai dengan teks yang ditentukan. Misalnya, jika berisi ListView dua item daftar - teks item pertama diatur ke "kurung sudut" dan teks item kedua diatur ke "tanda kurung" - panggilan untuk FindItemWithText meneruskan "tanda kurung" sebagai parameter akan mengembalikan item yang teksnya adalah "tanda kurung".

Metode FindItemWithText mengembalikan null jika daftar kosong atau tidak ada item yang cocok.

FindItemWithText(String, Boolean, Int32, Boolean)

Menemukan yang pertama ListViewItem atau ListViewItem.ListViewSubItem, jika ditunjukkan, yang dimulai dengan nilai teks yang ditentukan. Pencarian dimulai pada indeks yang ditentukan.

public:
 System::Windows::Forms::ListViewItem ^ FindItemWithText(System::String ^ text, bool includeSubItemsInSearch, int startIndex, bool isPrefixSearch);

public System.Windows.Forms.ListViewItem? FindItemWithText (string text, bool includeSubItemsInSearch, int startIndex, bool isPrefixSearch);

member this.FindItemWithText : string * bool * int * bool -> System.Windows.Forms.ListViewItem

Public Function FindItemWithText (text As String, includeSubItemsInSearch As Boolean, startIndex As Integer, isPrefixSearch As Boolean) As ListViewItem

Parameter

text

String

Teks yang akan dicari.

includeSubItemsInSearch

Boolean

true untuk menyertakan subitem dalam pencarian; jika tidak, false.

startIndex

Int32

Indeks item untuk memulai pencarian.

isPrefixSearch

Boolean

true untuk mengizinkan kecocokan parsial; jika tidak, false.

Mengembalikan

ListViewItem

Yang pertama ListViewItem dimulai dengan nilai teks yang ditentukan.

Pengecualian

ArgumentOutOfRangeException

startIndex kurang dari 0 atau lebih dari jumlah item di ListView.

Keterangan

Metode FindItemWithText mengembalikan null jika daftar kosong atau tidak ada item yang cocok.

Pencarian tidak peka huruf besar/kecil.

Parameter text dapat menentukan substring dari teks pencocokan yang diinginkan. Metode ini akan mengembalikan item pertama yang dimulai dengan teks yang ditentukan, kecuali false diteruskan untuk isPrefixSearch. Misalnya, jika berisi ListView dua item daftar - teks item pertama diatur ke "kurung sudut" dan teks item kedua diatur ke "tanda kurung" - panggilan untuk FindItemWithText meneruskan "tanda kurung" karena teks pencarian akan mengembalikan item yang teksnya adalah "tanda kurung". Jika isPrefixSearch diatur ke false, panggilan ini akan mengembalikan null.