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 Form 中，並從表單的建構函式或 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 包含兩個清單專案 - 第一個專案的文字設定為 「angle bracket」 ，而第二個專案的文字設定為 「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 包含兩個清單專案 - 第一個專案的文字設定為 「angle bracket」 且第二個專案的文字設定為 「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 包含兩個清單專案 - 第一個專案的文字設定為 「angle bracket」 且第二個專案的文字設定為 「bracket」 - FindItemWithText 呼叫傳遞 「brack」，因為搜尋文字會傳回文字為 「bracket」 的專案。 如果 isPrefixSearch 設定為 false ，則此呼叫會傳回 null 。