ListView.FindItemWithText Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Sucht das erste ListViewItem, das mit dem angegebenen Textwert beginnt.

Überlädt

FindItemWithText(String)	Sucht das erste ListViewItem, das mit dem angegebenen Textwert beginnt.
FindItemWithText(String, Boolean, Int32)	Sucht das erste ListViewItem oder, sofern angegeben, das erste ListViewItem.ListViewSubItem, das mit dem angegebenen Textwert beginnt. Die Suche beginnt am angegebenen Index.
FindItemWithText(String, Boolean, Int32, Boolean)	Sucht das erste ListViewItem oder, sofern angegeben, das erste ListViewItem.ListViewSubItem, das mit dem angegebenen Textwert beginnt. Die Suche beginnt am angegebenen Index.

FindItemWithText(String)

Sucht das erste ListViewItem, das mit dem angegebenen Textwert beginnt.

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

Parameter

text

String

Der zu suchende Text.

Gibt zurück

ListViewItem

Das erste ListViewItem, das mit dem angegebenen Textwert beginnt.

Beispiele

Im folgenden Codebeispiel wird die FindItemWithText -Methode veranschaulicht. Fügen Sie zum Ausführen dieses Beispiels den folgenden Code in ein Windows Form-Objekt ein, und rufen Sie die InitializeFindListView -Methode aus dem Konstruktor oder Load Ereignishandler des Formulars auf. Klicken Sie auf die Schaltfläche, um die Ergebnisse des Methodenaufrufs anzuzeigen.

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

Hinweise

Die Groß- und Kleinschreibung wird bei der Suche nicht berücksichtigt.

Der text Parameter kann eine Teilzeichenfolge des gewünschten übereinstimmenden Texts angeben. Darüber hinaus gibt diese Methode das erste Element zurück, das mit dem angegebenen Text beginnt. Wenn z. B. zwei ListView Listenelemente enthält – der Text des ersten Elements ist auf "eckige Klammer" und der Text des zweiten Elements auf "Klammer" festgelegt – gibt ein Aufruf von FindItemWithText übergeben brack als Parameter das Element zurück, dessen Text "Klammer" ist.

Die FindItemWithText -Methode gibt zurück null , wenn die Liste leer ist oder kein übereinstimmende Element vorhanden ist.

FindItemWithText(String, Boolean, Int32)

Sucht das erste ListViewItem oder, sofern angegeben, das erste ListViewItem.ListViewSubItem, das mit dem angegebenen Textwert beginnt. Die Suche beginnt am angegebenen 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

Parameter

text

String

Der zu suchende Text.

includeSubItemsInSearch

Boolean

true, wenn Unterelemente in der Suche enthalten sein sollen, andernfalls false.

startIndex

Int32

Der Index des Elements, bei dem mit der Suche begonnen werden soll.

Gibt zurück

ListViewItem

Das erste ListViewItem, das mit dem angegebenen Textwert beginnt.

Ausnahmen

ArgumentOutOfRangeException

startIndex ist kleiner als 0 (null) oder größer als die Anzahl der Elemente in ListView.

Hinweise

Die Groß- und Kleinschreibung wird bei der Suche nicht berücksichtigt.

Der text Parameter kann eine Teilzeichenfolge des gewünschten übereinstimmenden Texts angeben. Darüber hinaus gibt diese Methode das erste Element zurück, das mit dem angegebenen Text beginnt. Wenn z. B ListView . zwei Listenelemente enthält – der Text des ersten Elements ist auf "eckige Klammer" und der Text des zweiten Elements auf "Klammer" festgelegt – gibt ein Aufruf von FindItemWithText "brack" als Parameter das Element zurück, dessen Text "Klammer" ist.

Die FindItemWithText -Methode gibt zurück null , wenn die Liste leer ist oder kein übereinstimmende Element vorhanden ist.

FindItemWithText(String, Boolean, Int32, Boolean)

Sucht das erste ListViewItem oder, sofern angegeben, das erste ListViewItem.ListViewSubItem, das mit dem angegebenen Textwert beginnt. Die Suche beginnt am angegebenen 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

Parameter

text

String

Der zu suchende Text.

includeSubItemsInSearch

Boolean

true, wenn Unterelemente in der Suche enthalten sein sollen, andernfalls false.

startIndex

Int32

Der Index des Elements, bei dem mit der Suche begonnen werden soll.

isPrefixSearch

Boolean

true, wenn Teilübereinstimmungen zulässig sind, andernfalls false.

Gibt zurück

ListViewItem

Das erste ListViewItem, das mit dem angegebenen Textwert beginnt.

Ausnahmen

ArgumentOutOfRangeException

startIndex ist kleiner als 0 (null) oder größer als die Anzahl der Elemente in der ListView.

Hinweise

Die FindItemWithText -Methode gibt zurück null , wenn die Liste leer ist oder kein übereinstimmende Element vorhanden ist.

Die Groß- und Kleinschreibung wird bei der Suche nicht berücksichtigt.

Der text Parameter kann eine Teilzeichenfolge des gewünschten übereinstimmenden Texts angeben. Diese Methode gibt das erste Element zurück, das mit dem angegebenen Text beginnt, es sei denn false , es wird für isPrefixSearchübergeben. Wenn z. B. zwei ListView Listenelemente enthält – der Text des ersten Elements ist auf "eckige Klammer" und der Text des zweiten Elements auf "Klammer" festgelegt – gibt ein Aufruf von FindItemWithText "brack" als Suchtext das Element zurück, dessen Text "Klammer" ist. Wenn isPrefixSearch auf falsefestgelegt ist, gibt dieser Aufruf zurück null.