ListView.FindItemWithText Метод

Определение

Находит первый элемент ListViewItem, который начинается с заданного текстового значения.Finds the first ListViewItem with that begins with the given text value.

Перегрузки

FindItemWithText(String)

Находит первый элемент ListViewItem, который начинается с указанного текстового значения.Finds the first ListViewItem that begins with the specified text value.

FindItemWithText(String, Boolean, Int32)

Находит первый элемент ListViewItem или ListViewItem.ListViewSubItem (если указано), который начинается с заданного текстового значения.Finds the first ListViewItem or ListViewItem.ListViewSubItem, if indicated, that begins with the specified text value. Поиск начинается с указанного индекса.The search starts at the specified index.

FindItemWithText(String, Boolean, Int32, Boolean)

Находит первый элемент ListViewItem или ListViewItem.ListViewSubItem (если указано), который начинается с заданного текстового значения.Finds the first ListViewItem or ListViewItem.ListViewSubItem, if indicated, that begins with the specified text value. Поиск начинается с указанного индекса.The search starts at the specified index.

FindItemWithText(String)

Находит первый элемент ListViewItem, который начинается с указанного текстового значения.Finds the first ListViewItem that begins with the specified text value.

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

Текст для поиска.The text to search for.

Возвраты

Первый элемент ListViewItem, который начинается с указанного текстового значения.The first ListViewItem that begins with the specified text value.

Примеры

В следующем примере кода демонстрируется метод FindItemWithText.The following code example demonstrates the FindItemWithText method. Чтобы выполнить этот пример, вставьте следующий код в форму Windows Forms и вызовите метод InitializeFindListView из конструктора формы или обработчика событий Load.To run this example, paste the following code into a Windows Form and call the InitializeFindListView method from the form's constructor or Load event handler. Нажмите кнопку, чтобы просмотреть результаты вызова метода.Click the button to see the results of the method call.

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

Комментарии

При поиске не учитывается регистр.The search is case-insensitive.

Параметр text может указывать подстроку нужного совпадающего текста.The text parameter can specify a substring of the desired matching text. Кроме того, этот метод возвратит первый элемент, который начинается с указанного текста.In addition, this method will return the first item that starts with the specified text. Например, если ListView содержит два элемента списка: для текста первого элемента задано значение "угловая скобка", а для текста второго элемента — "скобка" — вызов FindItemWithText путем передачи brack, так как параметр вернет элемент, текст которого имеет значение "скобка".For example, if a ListView contains two list items - the first item's text set to "angle bracket" and the second item's text set to "bracket" - a call to FindItemWithText passing brack as the parameter will return the item whose text is "bracket".

Метод FindItemWithText возвращает null, если список пуст или отсутствует соответствующий элемент.The FindItemWithText method returns null if the list is empty or there is no matching item.

FindItemWithText(String, Boolean, Int32)

Находит первый элемент ListViewItem или ListViewItem.ListViewSubItem (если указано), который начинается с заданного текстового значения.Finds the first ListViewItem or ListViewItem.ListViewSubItem, if indicated, that begins with the specified text value. Поиск начинается с указанного индекса.The search starts at the specified index.

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

Текст для поиска.The text to search for.

includeSubItemsInSearch
Boolean

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

startIndex
Int32

Индекс элемента, с которого требуется начать поиск.The index of the item at which to start the search.

Возвраты

Первый элемент ListViewItem, который начинается с указанного текстового значения.The first ListViewItem that begins with the specified text value.

Исключения

Параметр startIndex меньше нуля или больше количества элементов в элементе управления ListView.startIndex is less 0 or more than the number items in the ListView.

Комментарии

При поиске не учитывается регистр.The search is case-insensitive.

Параметр text может указывать подстроку нужного совпадающего текста.The text parameter can specify a substring of the desired matching text. Кроме того, этот метод возвратит первый элемент, который начинается с указанного текста.In addition, this method will return the first item that starts with the specified text. Например, если ListView содержит два элемента списка: для текста первого элемента задано значение "угловая скобка", а для текста второго элемента — "скобка" — вызов FindItemWithText путем передачи "бракк", так как параметр вернет элемент, чей текст имеет значение "квадратная скобка".For example, if a ListView contains two list items - the first item's text set to "angle bracket" and the second item's text set to "bracket" - a call to FindItemWithText passing "brack" as the parameter will return the item whose text is "bracket".

Метод FindItemWithText возвращает null, если список пуст или отсутствует соответствующий элемент.The FindItemWithText method returns null if the list is empty or there is no matching item.

FindItemWithText(String, Boolean, Int32, Boolean)

Находит первый элемент ListViewItem или ListViewItem.ListViewSubItem (если указано), который начинается с заданного текстового значения.Finds the first ListViewItem or ListViewItem.ListViewSubItem, if indicated, that begins with the specified text value. Поиск начинается с указанного индекса.The search starts at the specified index.

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

Текст для поиска.The text to search for.

includeSubItemsInSearch
Boolean

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

startIndex
Int32

Индекс элемента, с которого требуется начать поиск.The index of the item at which to start the search.

isPrefixSearch
Boolean

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

Возвраты

Первый элемент ListViewItem, который начинается с указанного текстового значения.The first ListViewItem that begins with the specified text value.

Исключения

Параметр startIndex меньше нуля или больше количества элементов в элементе управления ListView.startIndex is less than 0 or more than the number of items in the ListView.

Комментарии

Метод FindItemWithText возвращает null, если список пуст или отсутствует соответствующий элемент.The FindItemWithText method returns null if the list is empty or there is no matching item.

При поиске не учитывается регистр.The search is case-insensitive.

Параметр text может указывать подстроку нужного совпадающего текста.The text parameter can specify a substring of the desired matching text. Этот метод возвращает первый элемент, который начинается с указанного текста, если для isPrefixSearch не передается значение false.This method will return the first item that starts with the specified text, unless false is passed in for isPrefixSearch. Например, если ListView содержит два элемента списка: для текста первого элемента задано значение "угловая скобка", а для текста второго элемента — "скобка" — вызов FindItemWithText, передавая "бракк" в качестве искомого текста, будет возвращать элемент, текст которого — "скобка".For example, if a ListView contains two list items - the first item's text set to "angle bracket" and the second item's text set to "bracket" - a call to FindItemWithText passing "brack" as the search text will return the item whose text is "bracket". Если isPrefixSearch имеет значение false, этот вызов вернет null.If isPrefixSearch is set to false, this call will return null.

Применяется к