ListView.FindItemWithText Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

ListViewItem Verilen metin değeriyle başlayan ilk değeri bulur.

Aşırı Yüklemeler

FindItemWithText(String)	Belirtilen metin değeriyle başlayan ilk ListViewItem değeri bulur.
FindItemWithText(String, Boolean, Int32)	Belirtilmişse, belirtilen metin değeriyle başlayan ilk ListViewItem veya ListViewItem.ListViewSubItemöğesini bulur. Arama belirtilen dizinde başlar.
FindItemWithText(String, Boolean, Int32, Boolean)	Belirtilmişse, belirtilen metin değeriyle başlayan ilk ListViewItem veya ListViewItem.ListViewSubItemöğesini bulur. Arama belirtilen dizinde başlar.

FindItemWithText(String)

Belirtilen metin değeriyle başlayan ilk ListViewItem değeri bulur.

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

Parametreler

text

String

Aranacak metin.

Döndürülenler

ListViewItem

Belirtilen metin değeriyle başlayan ilk ListViewItem değer.

Örnekler

Aşağıdaki kod örneği yöntemini gösterir FindItemWithText . Bu örneği çalıştırmak için aşağıdaki kodu bir Windows Formuna yapıştırın ve formun InitializeFindListView oluşturucusundan veya Load olay işleyicisinden yöntemini çağırın. Yöntem çağrısının sonuçlarını görmek için düğmeye tıklayın.

// 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

Açıklamalar

Arama büyük/küçük harfe duyarlı değildir.

parametresi, text istenen eşleşen metnin alt dizesini belirtebilir. Ayrıca, bu yöntem belirtilen metinle başlayan ilk öğeyi döndürür. Örneğin, bir ListView öğesi iki liste öğesi içeriyorsa ( ilk öğenin metni "açılı ayraç" ve ikinci öğenin metni "köşeli ayraç" olarak ayarlanmışsa, parametre olarak geçirilecek brack çağrı FindItemWithText metni "köşeli ayraç" olan öğeyi döndürür.

Yöntem, FindItemWithText liste boşsa veya eşleşen öğe yoksa döndürür null .

FindItemWithText(String, Boolean, Int32)

Belirtilmişse, belirtilen metin değeriyle başlayan ilk ListViewItem veya ListViewItem.ListViewSubItemöğesini bulur. Arama belirtilen dizinde başlar.

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

Parametreler

text

String

Aranacak metin.

includeSubItemsInSearch

Boolean

true araya alt öğeleri eklemek için; aksi takdirde , false.

startIndex

Int32

Aramanın başlatıldığı öğenin dizini.

Döndürülenler

ListViewItem

Belirtilen metin değeriyle başlayan ilk ListViewItem değer.

Özel durumlar

ArgumentOutOfRangeException

startIndex , içindeki ListViewsayı öğelerinden 0 veya daha fazladır.

Açıklamalar

Arama büyük/küçük harfe duyarlı değildir.

parametresi, text istenen eşleşen metnin alt dizesini belirtebilir. Ayrıca, bu yöntem belirtilen metinle başlayan ilk öğeyi döndürür. Örneğin, bir ListView öğesi iki liste öğesi içeriyorsa ( ilk öğenin metni "açılı ayraç" ve ikinci öğenin metni "köşeli ayraç" olarak ayarlanmışsa- parametre olarak "brack" geçirme çağrısı FindItemWithText metni "köşeli ayraç" olan öğeyi döndürür.

Yöntem, FindItemWithText liste boşsa veya eşleşen öğe yoksa döndürür null .

FindItemWithText(String, Boolean, Int32, Boolean)

Belirtilmişse, belirtilen metin değeriyle başlayan ilk ListViewItem veya ListViewItem.ListViewSubItemöğesini bulur. Arama belirtilen dizinde başlar.

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

Parametreler

text

String

Aranacak metin.

includeSubItemsInSearch

Boolean

true araya alt öğeleri eklemek için; aksi takdirde , false.

startIndex

Int32

Aramanın başlatıldığı öğenin dizini.

isPrefixSearch

Boolean

true kısmi eşleşmelere izin vermek için; aksi takdirde , false.

Döndürülenler

ListViewItem

Belirtilen metin değeriyle başlayan ilk ListViewItem değer.

Özel durumlar

ArgumentOutOfRangeException

startIndex , içindeki öğe ListViewsayısından 0'dan küçük veya daha fazladır.

Açıklamalar

Yöntem, FindItemWithText liste boşsa veya eşleşen öğe yoksa döndürür null .

Arama büyük/küçük harfe duyarlı değildir.

parametresi, text istenen eşleşen metnin alt dizesini belirtebilir. Bu yöntem, için isPrefixSearchgeçirilmediği sürece false belirtilen metinle başlayan ilk öğeyi döndürür. Örneğin, bir ListView öğesi iki liste öğesi içeriyorsa ( ilk öğenin metni "açılı ayraç" olarak, ikinci öğenin metni de "köşeli ayraç" olarak ayarlanmışsa, arama metni "köşeli ayraç" olan öğeyi döndüreceği için "brack" geçirme çağrısı FindItemWithText . olarak ayarlanırsa isPrefixSearchfalse, bu çağrı döndürür null.