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

Définition

Recherche le premier ListViewItem qui commence par la valeur texte donnée.Finds the first ListViewItem with that begins with the given text value.

Surcharges

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

Recherche le premier ListViewItem qui commence par la valeur texte spécifiée.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)

Recherche le premier ListViewItem ou ListViewItem.ListViewSubItem, s’il est indiqué, qui commence par la valeur texte spécifiée.Finds the first ListViewItem or ListViewItem.ListViewSubItem, if indicated, that begins with the specified text value. La recherche commence à l'index spécifié.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)

Recherche le premier ListViewItem ou ListViewItem.ListViewSubItem, s’il est indiqué, qui commence par la valeur texte spécifiée.Finds the first ListViewItem or ListViewItem.ListViewSubItem, if indicated, that begins with the specified text value. La recherche commence à l'index spécifié.The search starts at the specified index.

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

Recherche le premier ListViewItem qui commence par la valeur texte spécifiée.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

Paramètres

text
String String String String

Texte à rechercher.The text to search for.

Retours

Le premier ListViewItem qui commence par la valeur texte spécifiée.The first ListViewItem that begins with the specified text value.

Exemples

L’exemple de code suivant montre le FindItemWithText (méthode).The following code example demonstrates the FindItemWithText method. Pour exécuter cet exemple, collez le code suivant dans un Windows Form et appelez le InitializeFindListView méthode à partir du constructeur du formulaire ou Load Gestionnaire d’événements.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. Cliquez sur le bouton pour afficher les résultats de l’appel de méthode.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

Remarques

La recherche respecte la casse.The search is case-insensitive.

Le text paramètre peut spécifier une sous-chaîne du texte correspondant souhaité.The text parameter can specify a substring of the desired matching text. En outre, cette méthode retourne le premier élément qui commence par le texte spécifié.In addition, this method will return the first item that starts with the specified text. Par exemple, si un ListView contient deux éléments de liste - texte du premier élément défini sur « chevron » et du texte du deuxième élément « bracket » - un appel à la valeur FindItemWithText passant brack comme paramètre retourne l’élément dont le texte est « 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".

Le FindItemWithText retourne de la méthode null si la liste est vide ou si aucun élément correspondant.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)

Recherche le premier ListViewItem ou ListViewItem.ListViewSubItem, s’il est indiqué, qui commence par la valeur texte spécifiée.Finds the first ListViewItem or ListViewItem.ListViewSubItem, if indicated, that begins with the specified text value. La recherche commence à l'index spécifié.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

Paramètres

text
String String String String

Texte à rechercher.The text to search for.

includeSubItemsInSearch
Boolean Boolean Boolean Boolean

true Pour inclure des sous-éléments dans la recherche ; Sinon, false.true to include subitems in the search; otherwise, false.

startIndex
Int32 Int32 Int32 Int32

Index de l'élément à partir duquel commencer la recherche.The index of the item at which to start the search.

Retours

Le premier ListViewItem qui commence par la valeur texte spécifiée.The first ListViewItem that begins with the specified text value.

Exceptions

startIndex est inférieur à 0 ou supérieur au nombre d’éléments dans le ListView.startIndex is less 0 or more than the number items in the ListView.

Remarques

La recherche respecte la casse.The search is case-insensitive.

Le text paramètre peut spécifier une sous-chaîne du texte correspondant souhaité.The text parameter can specify a substring of the desired matching text. En outre, cette méthode retourne le premier élément qui commence par le texte spécifié.In addition, this method will return the first item that starts with the specified text. Par exemple, si un ListView contient deux éléments de liste - texte du premier élément défini sur « chevron » et du texte du deuxième élément « bracket » - un appel à la valeur FindItemWithText qui passe « CROC » comme paramètre retourne l’élément dont le texte est « 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".

Le FindItemWithText retourne de la méthode null si la liste est vide ou si aucun élément correspondant.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)

Recherche le premier ListViewItem ou ListViewItem.ListViewSubItem, s’il est indiqué, qui commence par la valeur texte spécifiée.Finds the first ListViewItem or ListViewItem.ListViewSubItem, if indicated, that begins with the specified text value. La recherche commence à l'index spécifié.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

Paramètres

text
String String String String

Texte à rechercher.The text to search for.

includeSubItemsInSearch
Boolean Boolean Boolean Boolean

true Pour inclure des sous-éléments dans la recherche ; Sinon, false.true to include subitems in the search; otherwise, false.

startIndex
Int32 Int32 Int32 Int32

Index de l'élément à partir duquel commencer la recherche.The index of the item at which to start the search.

isPrefixSearch
Boolean Boolean Boolean Boolean

true Pour autoriser les correspondances partielles ; Sinon, false.true to allow partial matches; otherwise, false.

Retours

Le premier ListViewItem qui commence par la valeur texte spécifiée.The first ListViewItem that begins with the specified text value.

Exceptions

startIndex est inférieur à 0 ou supérieur au nombre d’éléments dans le ListView.startIndex is less than 0 or more than the number of items in the ListView.

Remarques

Le FindItemWithText retourne de la méthode null si la liste est vide ou si aucun élément correspondant.The FindItemWithText method returns null if the list is empty or there is no matching item.

La recherche respecte la casse.The search is case-insensitive.

Le text paramètre peut spécifier une sous-chaîne du texte correspondant souhaité.The text parameter can specify a substring of the desired matching text. Cette méthode retourne le premier élément qui commence par le texte spécifié, à moins que false est passée pour isPrefixSearch.This method will return the first item that starts with the specified text, unless false is passed in for isPrefixSearch. Par exemple, si un ListView contient deux éléments de liste - texte du premier élément défini sur « chevron » et du texte du deuxième élément « bracket » - un appel à la valeur FindItemWithText qui passe « CROC » comme le texte de recherche retourne l’élément dont le texte est « 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". Si isPrefixSearch a la valeur false, cet appel retourne null.If isPrefixSearch is set to false, this call will return null.

S’applique à