Condividi tramite

ListView.FindItemWithText Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Trova la prima classe ListViewItem che inizia con il valore di testo fornito.

Overload

FindItemWithText(String)

Trova il primo oggetto ListViewItem che inizia con il valore di testo specificato.
FindItemWithText(String, Boolean, Int32)

Trova la prima classe ListViewItem o ListViewItem.ListViewSubItem, se indicata, che inizia con il valore di testo specificato. La ricerca inizia in corrispondenza dell'indice specificato.
FindItemWithText(String, Boolean, Int32, Boolean)

Trova la prima classe ListViewItem o ListViewItem.ListViewSubItem, se indicata, che inizia con il valore di testo specificato. La ricerca inizia in corrispondenza dell'indice specificato.

FindItemWithText(String)

Trova il primo oggetto ListViewItem che inizia con il valore di testo specificato.

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

Parametri

text
String

Testo da cercare.

Restituisce

ListViewItem

Prima classe ListViewItem che inizia con il valore di testo specificato.

Esempio

Nell'esempio di codice seguente viene illustrato il FindItemWithText metodo . Per eseguire questo esempio, incollare il codice seguente in un Windows Form e chiamare il InitializeFindListView metodo dal costruttore o Load dal gestore eventi del modulo. Fare clic sul pulsante per visualizzare i risultati della chiamata al metodo.

// 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

Commenti

La ricerca non fa distinzione tra maiuscole e minuscole.

Il text parametro può specificare una sottostringa del testo corrispondente desiderato. Inoltre, questo metodo restituirà il primo elemento che inizia con il testo specificato. Ad esempio, se un ListView oggetto contiene due elementi di elenco, il testo del primo elemento impostato su "parentesi angolare" e il testo del secondo elemento impostato su "parentesi quadre" - una chiamata al FindItemWithText passaggio brack come parametro restituirà l'elemento il cui testo è "parentesi quadre".

Il FindItemWithText metodo restituisce null se l'elenco è vuoto o non esiste alcun elemento corrispondente.

Si applica a

FindItemWithText(String, Boolean, Int32)

Trova la prima classe ListViewItem o ListViewItem.ListViewSubItem, se indicata, che inizia con il valore di testo specificato. La ricerca inizia in corrispondenza dell'indice specificato.

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

Parametri

text
String

Testo da cercare.

includeSubItemsInSearch
Boolean

true per includere gli elementi secondari nella ricerca; in caso contrario, false.

startIndex
Int32

Indice dell'elemento da cui iniziare la ricerca.

Restituisce

ListViewItem

Prima classe ListViewItem che inizia con il valore di testo specificato.

Eccezioni

ArgumentOutOfRangeException

Il parametro startIndex è minore di 0 o superiore al numero di elementi nella classe ListView.

Commenti

La ricerca non fa distinzione tra maiuscole e minuscole.

Il text parametro può specificare una sottostringa del testo corrispondente desiderato. Inoltre, questo metodo restituirà il primo elemento che inizia con il testo specificato. Ad esempio, se un ListView oggetto contiene due elementi di elenco, il testo del primo elemento impostato su "parentesi angolare" e il testo del secondo elemento impostato su "parentesi quadre" - una chiamata al FindItemWithText passaggio di "brack" come parametro restituirà l'elemento il cui testo è "parentesi quadre".

Il FindItemWithText metodo restituisce null se l'elenco è vuoto o non esiste alcun elemento corrispondente.

Si applica a

FindItemWithText(String, Boolean, Int32, Boolean)

Trova la prima classe ListViewItem o ListViewItem.ListViewSubItem, se indicata, che inizia con il valore di testo specificato. La ricerca inizia in corrispondenza dell'indice specificato.

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

Parametri

text
String

Testo da cercare.

includeSubItemsInSearch
Boolean

true per includere gli elementi secondari nella ricerca; in caso contrario, false.

startIndex
Int32

Indice dell'elemento da cui iniziare la ricerca.

isPrefixSearch
Boolean

true per consentire corrispondenze parziali; in caso contrario, false.

Restituisce

ListViewItem

Prima classe ListViewItem che inizia con il valore di testo specificato.

Eccezioni

ArgumentOutOfRangeException

Il parametro startIndex è minore di 0 o superiore al numero di elementi nella classe ListView.

Commenti

Il FindItemWithText metodo restituisce null se l'elenco è vuoto o non esiste alcun elemento corrispondente.

La ricerca non fa distinzione tra maiuscole e minuscole.

Il text parametro può specificare una sottostringa del testo corrispondente desiderato. Questo metodo restituirà il primo elemento che inizia con il testo specificato, a meno false che non venga passato per isPrefixSearch. Ad esempio, se un ListView oggetto contiene due elementi di elenco, il testo del primo elemento impostato su "parentesi angolare" e il testo del secondo elemento impostato su "parentesi quadre" - una chiamata al FindItemWithText passaggio di "brack" come il testo di ricerca restituirà l'elemento il cui testo è "parentesi quadre". Se isPrefixSearch è impostato su false, questa chiamata restituirà null.

Si applica a