ListView.FindItemWithText Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Znajduje pierwszy ListViewItem element rozpoczynający się od podanej wartości tekstowej.

Przeciążenia

FindItemWithText(String)	Znajduje pierwszy ListViewItem , który rozpoczyna się od określonej wartości tekstowej.
FindItemWithText(String, Boolean, Int32)	Znajduje pierwszy ListViewItem element lub ListViewItem.ListViewSubItem, jeśli jest wskazany, rozpoczynający się od określonej wartości tekstowej. Wyszukiwanie rozpoczyna się od określonego indeksu.
FindItemWithText(String, Boolean, Int32, Boolean)	Znajduje pierwszy ListViewItem element lub ListViewItem.ListViewSubItem, jeśli jest wskazany, rozpoczynający się od określonej wartości tekstowej. Wyszukiwanie rozpoczyna się od określonego indeksu.

FindItemWithText(String)

Znajduje pierwszy ListViewItem , który rozpoczyna się od określonej wartości tekstowej.

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

Parametry

text

String

Tekst do wyszukania.

Zwraca

ListViewItem

Pierwszy ListViewItem rozpoczynający się od określonej wartości tekstowej.

Przykłady

Poniższy przykład kodu przedstawia metodę FindItemWithText . Aby uruchomić ten przykład, wklej następujący kod do formularza systemu Windows i wywołaj InitializeFindListView metodę z konstruktora formularza lub Load procedury obsługi zdarzeń. Kliknij przycisk , aby wyświetlić wyniki wywołania metody.

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

Uwagi

Wyszukiwanie nie uwzględnia wielkości liter.

Parametr text może określać podciąg żądanego pasującego tekstu. Ponadto ta metoda zwróci pierwszy element rozpoczynający się od określonego tekstu. Jeśli na przykład element ListView zawiera dwa elementy listy — tekst pierwszego elementu ustawiony na "nawias kątowy", a tekst drugiego elementu ustawiony na "nawias" — wywołanie FindItemWithTextbrack przekazywania, ponieważ parametr zwróci element, którego tekst to "nawias".

Metoda FindItemWithText zwraca null wartość , jeśli lista jest pusta lub nie ma pasującego elementu.

FindItemWithText(String, Boolean, Int32)

Znajduje pierwszy ListViewItem element lub ListViewItem.ListViewSubItem, jeśli jest wskazany, rozpoczynający się od określonej wartości tekstowej. Wyszukiwanie rozpoczyna się od określonego indeksu.

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

Parametry

text

String

Tekst do wyszukania.

includeSubItemsInSearch

Boolean

true w celu uwzględnienia elementów podrzędnych w wyszukiwaniu; w przeciwnym razie , false.

startIndex

Int32

Indeks elementu, na którym ma rozpocząć wyszukiwanie.

Zwraca

ListViewItem

Pierwszy ListViewItem rozpoczynający się od określonej wartości tekstowej.

Wyjątki

ArgumentOutOfRangeException

startIndex wartość jest mniejsza niż 0 lub większa niż liczba elementów w elemecie ListView.

Uwagi

Wyszukiwanie nie uwzględnia wielkości liter.

Parametr text może określać podciąg żądanego pasującego tekstu. Ponadto ta metoda zwróci pierwszy element rozpoczynający się od określonego tekstu. Jeśli na przykład element ListView zawiera dwa elementy listy — tekst pierwszego elementu ustawiony na "nawias kątowy", a tekst drugiego elementu ustawiony na "nawias" — wywołanie FindItemWithText przekazywania "nawiasu klamrowego", ponieważ parametr zwróci element, którego tekst to "nawias".

Metoda FindItemWithText zwraca null wartość , jeśli lista jest pusta lub nie ma pasującego elementu.

FindItemWithText(String, Boolean, Int32, Boolean)

Znajduje pierwszy ListViewItem element lub ListViewItem.ListViewSubItem, jeśli jest wskazany, rozpoczynający się od określonej wartości tekstowej. Wyszukiwanie rozpoczyna się od określonego indeksu.

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

Parametry

text

String

Tekst do wyszukania.

includeSubItemsInSearch

Boolean

true w celu uwzględnienia elementów podrzędnych w wyszukiwaniu; w przeciwnym razie , false.

startIndex

Int32

Indeks elementu, na którym ma rozpocząć wyszukiwanie.

isPrefixSearch

Boolean

true umożliwianie częściowych dopasowań; w przeciwnym razie , false.

Zwraca

ListViewItem

Pierwszy ListViewItem rozpoczynający się od określonej wartości tekstowej.

Wyjątki

ArgumentOutOfRangeException

startIndex wartość jest mniejsza niż 0 lub większa niż liczba elementów w elemecie ListView.

Uwagi

Metoda FindItemWithText zwraca null wartość , jeśli lista jest pusta lub nie ma pasującego elementu.

Wyszukiwanie nie uwzględnia wielkości liter.

Parametr text może określać podciąg żądanego pasującego tekstu. Ta metoda zwróci pierwszy element rozpoczynający się od określonego tekstu, chyba że false zostanie przekazany dla elementu isPrefixSearch. Jeśli na przykład element ListView zawiera dwa elementy listy — tekst pierwszego elementu ustawiony na "nawias kątowy", a tekst drugiego elementu ustawiony na "nawias" — wywołanie FindItemWithText przekazywania "nawiasu klamrowego", ponieważ tekst wyszukiwania zwróci element, którego tekst to "nawias". Jeśli isPrefixSearch parametr ma wartość false, to wywołanie zwróci wartość null.