ListView.FindItemWithText Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Находит первый элемент ListViewItem, который начинается с заданного текстового значения.

Перегрузки

FindItemWithText(String)	Находит первый элемент ListViewItem, который начинается с указанного текстового значения.
FindItemWithText(String, Boolean, Int32)	Находит первый элемент ListViewItem или ListViewItem.ListViewSubItem (если указано), который начинается с заданного текстового значения. Поиск начинается с указанного индекса.
FindItemWithText(String, Boolean, Int32, Boolean)	Находит первый элемент ListViewItem или ListViewItem.ListViewSubItem (если указано), который начинается с заданного текстового значения. Поиск начинается с указанного индекса.

FindItemWithText(String)

Находит первый элемент ListViewItem, который начинается с указанного текстового значения.

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

Параметры

text

String

Текст для поиска.

Возвращаемое значение

ListViewItem

Первый элемент ListViewItem, который начинается с указанного текстового значения.

Примеры

В следующем примере кода демонстрируется FindItemWithText метод . Чтобы выполнить этот пример, вставьте следующий код в Форму Windows Forms и вызовите InitializeFindListView метод из конструктора формы или Load обработчика событий. Нажмите кнопку , чтобы просмотреть результаты вызова метода.

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

Комментарии

При поиске не учитывается регистр.

Параметр text может указать подстроку нужного соответствующего текста. Кроме того, этот метод возвращает первый элемент, начинающийся с указанного текста. Например, если ListView элемент содержит два элемента списка : текст первого элемента имеет значение "угловая скобка", а текст второго элемента имеет значение "bracket", вызов FindItemWithText передачи brack в качестве параметра вернет элемент, текст которого имеет значение "bracket".

Метод FindItemWithText возвращает значение null , если список пуст или нет соответствующего элемента.

FindItemWithText(String, Boolean, Int32)

Находит первый элемент ListViewItem или ListViewItem.ListViewSubItem (если указано), который начинается с заданного текстового значения. Поиск начинается с указанного индекса.

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

Параметры

text

String

Текст для поиска.

includeSubItemsInSearch

Boolean

true, чтобы выполнять поиск также и в подэлементах; в противном случае — false.

startIndex

Int32

Индекс элемента, с которого требуется начать поиск.

Возвращаемое значение

ListViewItem

Первый элемент ListViewItem, который начинается с указанного текстового значения.

Исключения

ArgumentOutOfRangeException

Параметр startIndex меньше нуля или больше количества элементов в элементе управления ListView.

Комментарии

При поиске не учитывается регистр.

Параметр text может указать подстроку нужного соответствующего текста. Кроме того, этот метод возвращает первый элемент, начинающийся с указанного текста. Например, если ListView содержит два элемента списка : текст первого элемента имеет значение "угловая скобка", а текст второго элемента имеет значение "bracket", то вызов FindItemWithText передачи "фигуры" в качестве параметра вернет элемент, текст которого имеет значение "bracket".

Метод FindItemWithText возвращает значение null , если список пуст или нет соответствующего элемента.

FindItemWithText(String, Boolean, Int32, Boolean)

Находит первый элемент ListViewItem или ListViewItem.ListViewSubItem (если указано), который начинается с заданного текстового значения. Поиск начинается с указанного индекса.

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

Параметры

text

String

Текст для поиска.

includeSubItemsInSearch

Boolean

true, чтобы выполнять поиск также и в подэлементах; в противном случае — false.

startIndex

Int32

Индекс элемента, с которого требуется начать поиск.

isPrefixSearch

Boolean

Значение true, чтобы разрешить частичные совпадения; в противном случае — значение false.

Возвращаемое значение

ListViewItem

Первый элемент ListViewItem, который начинается с указанного текстового значения.

Исключения

ArgumentOutOfRangeException

Параметр startIndex меньше нуля или больше количества элементов в элементе управления ListView.

Комментарии

Метод FindItemWithText возвращает значение null , если список пуст или нет соответствующего элемента.

При поиске не учитывается регистр.

Параметр text может указать подстроку нужного соответствующего текста. Этот метод возвращает первый элемент, начинающийся с указанного текста, если false не передается для isPrefixSearch. Например, если ListView содержит два элемента списка : текст первого элемента имеет значение "угловая скобка", а текст второго элемента имеет значение "bracket", вызов FindItemWithText передачи "фигурные скобки" в качестве текста поиска вернет элемент, текст которого является "скобка". Если isPrefixSearch задано значение false, этот вызов возвращает null.