ListView.FindItemWithText ListView.FindItemWithText ListView.FindItemWithText ListView.FindItemWithText Method

定義

最初に見つかったListViewItemを指定したテキスト値で始まります。Finds the first ListViewItem with that begins with the given text value.

オーバーロード

FindItemWithText(String) FindItemWithText(String) FindItemWithText(String) FindItemWithText(String)

最初に見つかったListViewItem指定したテキスト値で始まります。Finds the first ListViewItem that begins with the specified text value.

FindItemWithText(String, Boolean, Int32) FindItemWithText(String, Boolean, Int32) FindItemWithText(String, Boolean, Int32) 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) FindItemWithText(String, Boolean, Int32, Boolean) FindItemWithText(String, Boolean, Int32, Boolean) 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) FindItemWithText(String) FindItemWithText(String) 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 String String 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 フォームと呼び出しに次のコードを貼り付け、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 2 つのリスト アイテムの最初の項目のテキストが「山かっ」に設定し、2 番目の項目のテキストが"bracket"- への呼び出しに設定されてFindItemWithTextを渡すbrackように、パラメーターは、項目のテキストが"bracket"を返します。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) FindItemWithText(String, Boolean, Int32) FindItemWithText(String, Boolean, Int32) 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 String String String

検索するテキストです。The text to search for.

includeSubItemsInSearch
Boolean Boolean Boolean Boolean

true 検索にサブ項目を含めるそれ以外の場合、falseします。true to include subitems in the search; otherwise, false.

startIndex
Int32 Int32 Int32 Int32

検索を開始する位置の項目のインデックス。The index of the item at which to start the search.

戻り値

最初のListViewItem指定したテキスト値で始まります。The first ListViewItem that begins with the specified text value.

例外

startIndex 0 未満かよりも項目数、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 2 つのリスト アイテムの最初の項目のテキストが「山かっ」に設定し、2 番目の項目のテキストが"bracket"- への呼び出しに設定されてFindItemWithTextbrack"渡す"ように、パラメーターが返される項目のテキストが"bracket"。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) FindItemWithText(String, Boolean, Int32, Boolean) FindItemWithText(String, Boolean, Int32, Boolean) 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 String String String

検索するテキストです。The text to search for.

includeSubItemsInSearch
Boolean Boolean Boolean Boolean

true 検索にサブ項目を含めるそれ以外の場合、falseします。true to include subitems in the search; otherwise, false.

startIndex
Int32 Int32 Int32 Int32

検索を開始する位置の項目のインデックス。The index of the item at which to start the search.

isPrefixSearch
Boolean Boolean Boolean Boolean

true 部分的な一致を許可するにはそれ以外の場合、falseします。true to allow partial matches; otherwise, false.

戻り値

最初のListViewItem指定したテキスト値で始まります。The first ListViewItem that begins with the specified text value.

例外

startIndex 0 未満か、内の項目の数、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. このメソッドは、しない限り、指定したテキストで始まる最初の項目は返さfalseに渡されたisPrefixSearchします。This method will return the first item that starts with the specified text, unless false is passed in for isPrefixSearch. たとえば場合、 ListView 2 つのリスト アイテムの最初の項目のテキストが「山かっ」に設定し、2 番目の項目のテキストが"bracket"- への呼び出しに設定されてFindItemWithText渡す"brack"検索テキストはテキストに、項目に戻ると、"bracket"。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.

適用対象