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 Form에 다음 코드를 붙여 넣습니다 합니다 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 두 개의 목록 항목이-첫 번째 항목의 텍스트를 "꺾쇠 괄호"로 설정 하 고 "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 두 개의 목록 항목이-첫 번째 항목의 텍스트를 "꺾쇠 괄호"로 설정 하 고 "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, 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 두 개의 목록 항목이-첫 번째 항목의 텍스트를 "꺾쇠 괄호"로 설정 하 고 "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.

적용 대상