ListView.FindItemWithText メソッド

public:
 System::Windows::Forms::ListViewItem ^ FindItemWithText(System::String ^ text);

public System.Windows.Forms.ListViewItem FindItemWithText (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

パラメーター

戻り値

指定したテキスト値で始まる最初の 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 2 つのリスト アイテム (最初の項目のテキストが "山かっこ" に設定され、2 番目の項目のテキストが "角かっこ" に設定されている) が含まれている場合、 パラメーターとして を渡すbrack呼び出しFindItemWithTextは、テキストが "角かっこ" であるアイテムを返します。

リストが FindItemWithText 空の場合、または一致する項目がない場合、 メソッドは を返 null します。

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);

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

パラメーター

戻り値

指定したテキスト値で始まる最初の ListViewItem。

例外

注釈

検索では、大文字と小文字を区別しません。

パラメーターは text 、目的の一致するテキストの部分文字列を指定できます。 さらに、このメソッドは、指定したテキストで始まる最初の項目を返します。 たとえば、 に ListView 2 つのリスト アイテム (最初の項目のテキストセットが "山かっこ" に設定され、2 番目の項目のテキストが "bracket" に設定されている) が含まれている場合、パラメーターとして "中かっこ" を渡す呼び出し FindItemWithText は、テキストが "角かっこ" であるアイテムを返します。

リストが FindItemWithText 空の場合、または一致する項目がない場合、 メソッドは を返 null します。

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);

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

パラメーター

戻り値

指定したテキスト値で始まる最初の ListViewItem。

例外

注釈

リストが FindItemWithText 空の場合、または一致する項目がない場合、 メソッドは を返 null します。

検索では、大文字と小文字を区別しません。

パラメーターは text 、目的の一致するテキストの部分文字列を指定できます。 このメソッドは、 に 渡されない限り false 、指定したテキストで始まる最初の項目を isPrefixSearch返します。 たとえば、 に ListView 2 つのリスト アイテム (最初の項目のテキストセットが "山かっこ" に設定され、2 番目の項目のテキストが "角かっこ" に設定されている) が含まれている場合、検索テキストが "角かっこ" であるアイテムが返されるため、"中かっこ" を渡す呼び出し FindItemWithText が返されます。 が にfalse設定されている場合isPrefixSearch、この呼び出しは を返しますnull。