ListView.FindItemWithText Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Najde první ListViewItem hodnotu začínající danou textovou hodnotou.

Přetížení

Name	Description
FindItemWithText(String)	Najde první ListViewItem , který začíná zadanou textovou hodnotou.
FindItemWithText(String, Boolean, Int32)	Najde první ListViewItem nebo ListViewItem.ListViewSubItem, pokud je uvedeno, který začíná zadanou textovou hodnotou. Hledání začíná na zadaném indexu.
FindItemWithText(String, Boolean, Int32, Boolean)	Najde první ListViewItem nebo ListViewItem.ListViewSubItem, pokud je uvedeno, který začíná zadanou textovou hodnotou. Hledání začíná na zadaném indexu.

FindItemWithText(String)

Zdroj:

ListView.cs

Najde první ListViewItem , který začíná zadanou textovou hodnotou.

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

Parametry

text

String

Text, který chcete vyhledat.

Návraty

ListViewItem

První ListViewItem , který začíná zadanou textovou hodnotou.

Příklady

Následující příklad kódu ukazuje metodu FindItemWithText . Chcete-li spustit tento příklad, vložte následující kód do formuláře Windows a zavolejte InitializeFindListView metodu z konstruktoru formuláře nebo Load obslužné rutiny události. Kliknutím na tlačítko zobrazíte výsledky volání metody.

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

Poznámky

Hledání nerozlišuje malá a velká písmena.

Parametr text může zadat podřetětěsce požadovaného odpovídajícího textu. Kromě toho tato metoda vrátí první položku, která začíná zadaným textem. Pokud ListView například obsahuje dvě položky seznamu – text první položky nastavený na "úhel závorka" a text druhé položky nastavený na "hranatá závorka" – volání pro FindItemWithText předání brack , protože parametr vrátí položku, jejíž text je "hranatá".

Metoda FindItemWithText vrátí null , pokud je seznam prázdný nebo neexistuje žádná odpovídající položka.

FindItemWithText(String, Boolean, Int32)

Zdroj:

ListView.cs

Najde první ListViewItem nebo ListViewItem.ListViewSubItem, pokud je uvedeno, který začíná zadanou textovou hodnotou. Hledání začíná na zadaném indexu.

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

Parametry

text

String

Text, který chcete vyhledat.

includeSubItemsInSearch

Boolean

truezahrnout dílčí položky do hledání; v opačném případě . false

startIndex

Int32

Index položky, na které se má vyhledávání spustit.

Návraty

ListViewItem

První ListViewItem , který začíná zadanou textovou hodnotou.

Výjimky

ArgumentOutOfRangeException

startIndex je menší než 0 nebo více než počet položek v sadě ListView.

Poznámky

Hledání nerozlišuje malá a velká písmena.

Parametr text může zadat podřetětěsce požadovaného odpovídajícího textu. Kromě toho tato metoda vrátí první položku, která začíná zadaným textem. Pokud ListView například obsahuje dvě položky seznamu – text první položky nastavený na "úhel závorka" a text druhé položky nastavený na "hranatý" – volání pro FindItemWithText předání "brack" jako parametr vrátí položku, jejíž text je "závorka".

Metoda FindItemWithText vrátí null , pokud je seznam prázdný nebo neexistuje žádná odpovídající položka.

FindItemWithText(String, Boolean, Int32, Boolean)

Zdroj:

ListView.cs

Najde první ListViewItem nebo ListViewItem.ListViewSubItem, pokud je uvedeno, který začíná zadanou textovou hodnotou. Hledání začíná na zadaném indexu.

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

Parametry

text

String

Text, který chcete vyhledat.

includeSubItemsInSearch

Boolean

truezahrnout dílčí položky do hledání; v opačném případě . false

startIndex

Int32

Index položky, na které se má vyhledávání spustit.

isPrefixSearch

Boolean

truepovolit částečné shody; v opačném případě . false

Návraty

ListViewItem

První ListViewItem , který začíná zadanou textovou hodnotou.

Výjimky

ArgumentOutOfRangeException

startIndex je menší než 0 nebo více než počet položek v sadě ListView.

Poznámky

Metoda FindItemWithText vrátí null , pokud je seznam prázdný nebo neexistuje žádná odpovídající položka.

Hledání nerozlišuje malá a velká písmena.

Parametr text může zadat podřetětěsce požadovaného odpovídajícího textu. Tato metoda vrátí první položku, která začíná zadaným textem, pokud false není předána pro isPrefixSearch. Pokud ListView například obsahuje dvě položky seznamu – text první položky nastavený na "úhel závorka" a text druhé položky nastavený na "hranatá závorka" – volání pro FindItemWithText předání "brack" jako hledaný text vrátí položku, jejíž text je "hranatá". Pokud isPrefixSearch je nastavená hodnota false, vrátí se tento hovor null.