ListView.FindItemWithText Méthode
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Recherche le premier ListViewItem qui commence par la valeur texte donnée.
FindItemWithText(String) |
Recherche le premier ListViewItem qui commence par la valeur texte spécifiée. |
FindItemWithText(String, Boolean, Int32) |
Recherche le premier ListViewItem ou ListViewItem.ListViewSubItem, s'il est indiqué, qui commence par la valeur texte spécifiée. La recherche commence à l'index spécifié. |
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. La recherche commence à l'index spécifié. |
Recherche le premier ListViewItem qui commence par la valeur texte spécifiée.
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
Paramètres
- text
- String
Texte à rechercher.
Retours
Premier ListViewItem qui commence par la valeur texte spécifiée.
Exemples
L’exemple de code suivant illustre la FindItemWithText méthode. Pour exécuter cet exemple, collez le code suivant dans un Windows Form et appelez la InitializeFindListView
méthode à partir du constructeur ou Load du gestionnaire d’événements du formulaire. Cliquez sur le bouton pour afficher les résultats de l’appel de méthode.
// 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.
Le text
paramètre peut spécifier une sous-chaîne du texte correspondant souhaité. En outre, cette méthode retourne le premier élément qui commence par le texte spécifié. Par exemple, si un ListView contient deux éléments de liste - le texte du premier élément défini sur « crochet » et le texte du deuxième élément défini sur « crochet » - un appel à FindItemWithText passer brack
en tant que paramètre renvoie l’élément dont le texte est « crochet ».
La FindItemWithText méthode retourne null
si la liste est vide ou s’il n’y a pas d’élément correspondant.
S’applique à
.NET Framework 4.8.1 et autres versions
Produit | Versions |
---|---|
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
Recherche le premier ListViewItem ou ListViewItem.ListViewSubItem, s'il est indiqué, qui commence par la valeur texte spécifiée. La recherche commence à l'index spécifié.
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
Paramètres
- text
- String
Texte à rechercher.
- includeSubItemsInSearch
- Boolean
true
pour inclure des sous-éléments dans la recherche ; sinon, false
.
- startIndex
- Int32
Index de l'élément à partir duquel commencer la recherche.
Retours
Premier ListViewItem qui commence par la valeur texte spécifiée.
Exceptions
startIndex
est inférieur à 0 ou supérieur au nombre d'éléments dans ListView.
Remarques
La recherche respecte la casse.
Le text
paramètre peut spécifier une sous-chaîne du texte correspondant souhaité. En outre, cette méthode retourne le premier élément qui commence par le texte spécifié. Par exemple, si un ListView contient deux éléments de liste - le texte du premier élément défini sur « crochet » et le texte du deuxième élément défini sur « crochet » - un appel au FindItemWithText passage de « brack » en tant que paramètre renvoie l’élément dont le texte est « crochet ».
La FindItemWithText méthode retourne null
si la liste est vide ou s’il n’y a pas d’élément correspondant.
S’applique à
.NET Framework 4.8.1 et autres versions
Produit | Versions |
---|---|
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
Recherche le premier ListViewItem ou ListViewItem.ListViewSubItem, s'il est indiqué, qui commence par la valeur texte spécifiée. La recherche commence à l'index spécifié.
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
Paramètres
- text
- String
Texte à rechercher.
- includeSubItemsInSearch
- Boolean
true
pour inclure des sous-éléments dans la recherche ; sinon, false
.
- startIndex
- Int32
Index de l'élément à partir duquel commencer la recherche.
- isPrefixSearch
- Boolean
true
pour autoriser les correspondances partielles ; sinon, false
.
Retours
Premier ListViewItem qui commence par la valeur texte spécifiée.
Exceptions
startIndex
est inférieur à 0 ou supérieur au nombre d'éléments dans ListView.
Remarques
La FindItemWithText méthode retourne null
si la liste est vide ou s’il n’y a pas d’élément correspondant.
La recherche respecte la casse.
Le text
paramètre peut spécifier une sous-chaîne du texte correspondant souhaité. Cette méthode retourne le premier élément qui commence par le texte spécifié, sauf s’il false
est passé pour isPrefixSearch
. Par exemple, si un ListView contient deux éléments de liste - le texte du premier élément défini sur « crochet » et le texte du deuxième élément défini sur « crochet » - un appel à FindItemWithText passer « brack » comme texte de recherche renvoie l’élément dont le texte est « crochet ». Si isPrefixSearch
est défini sur false
, cet appel retourne null
.
S’applique à
.NET Framework 4.8.1 et autres versions
Produit | Versions |
---|---|
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
Commentaires sur .NET
.NET est un projet open source. Sélectionnez un lien pour fournir des commentaires :