ListView.FindItemWithText Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Localiza o primeiro ListViewItem que começa com o valor de texto fornecido.

Sobrecargas

FindItemWithText(String)	Localiza o primeiro ListViewItem que começa com o valor de texto especificado.
FindItemWithText(String, Boolean, Int32)	Localiza o primeiro ListViewItem ou ListViewItem.ListViewSubItem, se indicado, que começa com o valor de texto especificado. A pesquisa começa no índice especificado.
FindItemWithText(String, Boolean, Int32, Boolean)	Localiza o primeiro ListViewItem ou ListViewItem.ListViewSubItem, se indicado, que começa com o valor de texto especificado. A pesquisa começa no índice especificado.

FindItemWithText(String)

Localiza o primeiro ListViewItem que começa com o valor de texto especificado.

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

Parâmetros

text

String

O texto a ser pesquisado.

Retornos

ListViewItem

O primeiro ListViewItem que começa com o valor de texto especificado.

Exemplos

O exemplo de código a seguir demonstra o FindItemWithText método . Para executar este exemplo, cole o código a seguir em um Formulário do Windows e chame o InitializeFindListView método do construtor ou Load manipulador de eventos do formulário. Clique no botão para ver os resultados da chamada de método.

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

Comentários

A pesquisa diferencia maiúsculas de minúsculas.

O text parâmetro pode especificar uma subcadeia de caracteres do texto correspondente desejado. Além disso, esse método retornará o primeiro item que começa com o texto especificado. Por exemplo, se um ListView contiver dois itens de lista - o texto do primeiro item definido como "colchete angular" e o texto do segundo item definido como "colchete" - uma chamada para FindItemWithText passar brack como o parâmetro retornará o item cujo texto é "colchete".

O FindItemWithText método retornará null se a lista estiver vazia ou se não houver nenhum item correspondente.

FindItemWithText(String, Boolean, Int32)

Localiza o primeiro ListViewItem ou ListViewItem.ListViewSubItem, se indicado, que começa com o valor de texto especificado. A pesquisa começa no índice especificado.

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

Parâmetros

text

String

O texto a ser pesquisado.

includeSubItemsInSearch

Boolean

true para incluir os subitens na pesquisa, caso contrário, false.

startIndex

Int32

O índice do item no qual iniciar a pesquisa.

Retornos

ListViewItem

O primeiro ListViewItem que começa com o valor de texto especificado.

Exceções

ArgumentOutOfRangeException

startIndex é menor que 0 ou maior que o número de itens na ListView.

Comentários

A pesquisa diferencia maiúsculas de minúsculas.

O text parâmetro pode especificar uma subcadeia de caracteres do texto correspondente desejado. Além disso, esse método retornará o primeiro item que começa com o texto especificado. Por exemplo, se um ListView contiver dois itens de lista - o texto do primeiro item definido como "colchete angular" e o texto do segundo item definido como "colchete" - uma chamada para FindItemWithText passar "brack" como o parâmetro retornará o item cujo texto é "colchete".

O FindItemWithText método retornará null se a lista estiver vazia ou se não houver nenhum item correspondente.

FindItemWithText(String, Boolean, Int32, Boolean)

Localiza o primeiro ListViewItem ou ListViewItem.ListViewSubItem, se indicado, que começa com o valor de texto especificado. A pesquisa começa no índice especificado.

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

Parâmetros

text

String

O texto a ser pesquisado.

includeSubItemsInSearch

Boolean

true para incluir os subitens na pesquisa, caso contrário, false.

startIndex

Int32

O índice do item no qual iniciar a pesquisa.

isPrefixSearch

Boolean

true para permitir correspondências parciais, caso contrário, false.

Retornos

ListViewItem

O primeiro ListViewItem que começa com o valor de texto especificado.

Exceções

ArgumentOutOfRangeException

startIndex é menor que 0 ou maior que o número de itens na ListView.

Comentários

O FindItemWithText método retornará null se a lista estiver vazia ou se não houver nenhum item correspondente.

A pesquisa diferencia maiúsculas de minúsculas.

O text parâmetro pode especificar uma subcadeia de caracteres do texto correspondente desejado. Esse método retornará o primeiro item que começa com o texto especificado, a menos que false seja passado para isPrefixSearch. Por exemplo, se um ListView contiver dois itens de lista - o texto do primeiro item definido como "colchete angular" e o texto do segundo item definido como "colchete" - uma chamada para FindItemWithText passar "brack" como o texto de pesquisa retornará o item cujo texto é "colchete". Se isPrefixSearch estiver definido como false, essa chamada retornará null.