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 窗体中，并从窗体的构造函数或Load事件处理程序调用 InitializeFindListView 方法。 单击按钮可查看方法调用的结果。

// 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 小于 0 或大于 ListView 中的项的数量。

注解

搜索不区分大小写。

参数 text 可以指定所需匹配文本的子字符串。 此外，此方法将返回以指定文本开头的第一项。 例如，如果 包含两个 ListView 列表项-第一项的文本设置为“尖括号”，第二项的文本设置为“bracket”，则调用 FindItemWithText 将“brack”作为 参数传递将返回其文本为“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 小于 0 或大于 ListView 中的项的数量。

注解

如果列表为空或没有匹配项，则 FindItemWithText 方法返回 null 。

搜索不区分大小写。

参数 text 可以指定所需匹配文本的子字符串。 此方法将返回以指定文本开头的第一项，除非 false 为 isPrefixSearch传入 。 例如，如果 包含两个 ListView 列表项-第一项的文本设置为“尖括号”，第二项的文本设置为“bracket”，则调用 FindItemWithText 将“brack”作为搜索文本传递将返回其文本为“bracket”的项。 如果 isPrefixSearch 设置为 false，则此调用将返回 null。