ListView.FindItemWithText Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Encuentra el primer objeto ListViewItem que comience por el valor de texto dado.

Sobrecargas

FindItemWithText(String)	Encuentra el primer objeto ListViewItem que comience con el valor de texto especificado.
FindItemWithText(String, Boolean, Int32)	Encuentra el primer objeto ListViewItem o ListViewItem.ListViewSubItem, si se ha indicado, que comience con el valor de texto especificado. La búsqueda se inicia en el índice especificado.
FindItemWithText(String, Boolean, Int32, Boolean)	Encuentra el primer objeto ListViewItem o ListViewItem.ListViewSubItem, si se ha indicado, que comience con el valor de texto especificado. La búsqueda se inicia en el índice especificado.

FindItemWithText(String)

Encuentra el primer objeto ListViewItem que comience con el 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

Texto que se va a buscar.

Devoluciones

ListViewItem

Primer objeto ListViewItem que comienza con el valor de texto especificado.

Ejemplos

En el ejemplo de código siguiente se muestra el FindItemWithText método . Para ejecutar este ejemplo, pegue el código siguiente en un Formulario Windows Forms y llame al InitializeFindListView método desde el constructor o Load controlador de eventos del formulario. Haga clic en el botón para ver los resultados de la llamada al 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

Comentarios

La búsqueda no distingue entre mayúsculas y minúsculas.

El text parámetro puede especificar una subcadena del texto coincidente deseado. Además, este método devolverá el primer elemento que comienza con el texto especificado. Por ejemplo, si ListView contiene dos elementos de lista , el texto del primer elemento establecido en "corchete angular" y el texto del segundo elemento establecido en "corchete", una llamada a FindItemWithText pasar brack como parámetro devolverá el elemento cuyo texto es "corchete".

El FindItemWithText método devuelve null si la lista está vacía o no hay ningún elemento coincidente.

FindItemWithText(String, Boolean, Int32)

Encuentra el primer objeto ListViewItem o ListViewItem.ListViewSubItem, si se ha indicado, que comience con el valor de texto especificado. La búsqueda se inicia en el í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

Texto que se va a buscar.

includeSubItemsInSearch

Boolean

true para incluir los subelementos en la búsqueda; de lo contrario, false.

startIndex

Int32

Índice del elemento en el que se va a iniciar la búsqueda.

Devoluciones

ListViewItem

Primer objeto ListViewItem que comienza con el valor de texto especificado.

Excepciones

ArgumentOutOfRangeException

startIndex es menor que 0 o mayor que el número de elementos de ListView.

Comentarios

La búsqueda no distingue entre mayúsculas y minúsculas.

El text parámetro puede especificar una subcadena del texto coincidente deseado. Además, este método devolverá el primer elemento que comienza con el texto especificado. Por ejemplo, si ListView contiene dos elementos de lista, el texto del primer elemento establecido en "corchete angular" y el segundo elemento establecido en "corchete", una llamada a FindItemWithText pasar "brack" como parámetro devolverá el elemento cuyo texto es "corchete".

El FindItemWithText método devuelve null si la lista está vacía o no hay ningún elemento coincidente.

FindItemWithText(String, Boolean, Int32, Boolean)

Encuentra el primer objeto ListViewItem o ListViewItem.ListViewSubItem, si se ha indicado, que comience con el valor de texto especificado. La búsqueda se inicia en el í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

Texto que se va a buscar.

includeSubItemsInSearch

Boolean

true para incluir los subelementos en la búsqueda; de lo contrario, false.

startIndex

Int32

Índice del elemento en el que se va a iniciar la búsqueda.

isPrefixSearch

Boolean

Es true para permitir coincidencias parciales; de lo contrario, es false.

Devoluciones

ListViewItem

Primer objeto ListViewItem que comienza con el valor de texto especificado.

Excepciones

ArgumentOutOfRangeException

startIndex es menor que 0 o mayor que el número de elementos de ListView.

Comentarios

El FindItemWithText método devuelve null si la lista está vacía o no hay ningún elemento coincidente.

La búsqueda no distingue entre mayúsculas y minúsculas.

El text parámetro puede especificar una subcadena del texto coincidente deseado. Este método devolverá el primer elemento que comienza con el texto especificado, a menos false que se pase para isPrefixSearch. Por ejemplo, si ListView contiene dos elementos de lista, el texto del primer elemento establecido en "corchete angular" y el segundo elemento establecido en "corchete", una llamada a FindItemWithText pasar "brack" como el texto de búsqueda devolverá el elemento cuyo texto es "corchete". Si isPrefixSearch se establece en false, esta llamada devolverá null.