Compartir a través de


ListView.ListViewItemCollection.Insert Método

Definición

Inserta un elemento en el índice especificado de la colección.

Sobrecargas

Insert(Int32, String, String, String)

Crea un nuevo elemento con el texto, la imagen y la clave especificadas y lo agrega a la colección, en el índice especificado.

Insert(Int32, String, String, Int32)

Crea un nuevo elemento con el texto, la imagen y la clave especificadas y lo inserta en la colección, en el índice especificado.

Insert(Int32, String, String)

Crea un nuevo elemento con la imagen y el texto especificados y lo inserta en la colección, en el índice especificado.

Insert(Int32, ListViewItem)

Inserta un ListViewItem existente en el índice especificado de la colección.

Insert(Int32, String)

Crea un nuevo elemento y lo inserta en la colección, en el índice especificado.

Insert(Int32, String, Int32)

Crea un nuevo elemento con el índice de imágenes especificado y lo inserta en la colección, en el índice especificado.

Insert(Int32, String, String, String)

Crea un nuevo elemento con el texto, la imagen y la clave especificadas y lo agrega a la colección, en el índice especificado.

public:
 virtual System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ key, System::String ^ text, System::String ^ imageKey);
public virtual System.Windows.Forms.ListViewItem Insert (int index, string key, string text, string imageKey);
abstract member Insert : int * string * string * string -> System.Windows.Forms.ListViewItem
override this.Insert : int * string * string * string -> System.Windows.Forms.ListViewItem
Public Overridable Function Insert (index As Integer, key As String, text As String, imageKey As String) As ListViewItem

Parámetros

index
Int32

Ubicación del índice de base cero donde se inserta el elemento.

key
String

Name del elemento.

text
String

Texto del elemento.

imageKey
String

Clave de la imagen que se va a mostrar para el elemento.

Devoluciones

ListViewItem

ListViewItem agregado a la colección.

Excepciones

El parámetro index es menor que cero o mayor que el valor de la propiedad Count de ListView.ListViewItemCollection.

Comentarios

El Insert método establece la Name propiedad del elemento en la clave especificada, por lo que el elemento se puede recuperar por su índice o por clave.

Se aplica a

Insert(Int32, String, String, Int32)

Crea un nuevo elemento con el texto, la imagen y la clave especificadas y lo inserta en la colección, en el índice especificado.

public:
 virtual System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ key, System::String ^ text, int imageIndex);
public virtual System.Windows.Forms.ListViewItem Insert (int index, string key, string text, int imageIndex);
abstract member Insert : int * string * string * int -> System.Windows.Forms.ListViewItem
override this.Insert : int * string * string * int -> System.Windows.Forms.ListViewItem
Public Overridable Function Insert (index As Integer, key As String, text As String, imageIndex As Integer) As ListViewItem

Parámetros

index
Int32

Ubicación del índice de base cero donde se inserta el elemento.

key
String

Name del elemento.

text
String

Texto del elemento.

imageIndex
Int32

Índice de la imagen que se va a mostrar para el elemento.

Devoluciones

ListViewItem

ListViewItem agregado a la colección.

Excepciones

El parámetro index es menor que cero o mayor que el valor de la propiedad Count de ListView.ListViewItemCollection.

Comentarios

El Insert método establece la Name propiedad del elemento en la clave especificada, por lo que el elemento se puede recuperar por su índice o por clave.

Se aplica a

Insert(Int32, String, String)

Crea un nuevo elemento con la imagen y el texto especificados y lo inserta en la colección, en el índice especificado.

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text, System::String ^ imageKey);
public System.Windows.Forms.ListViewItem Insert (int index, string text, string imageKey);
member this.Insert : int * string * string -> System.Windows.Forms.ListViewItem
Public Function Insert (index As Integer, text As String, imageKey As String) As ListViewItem

Parámetros

index
Int32

Ubicación del índice de base cero donde se inserta el elemento.

text
String

El texto del ListViewItem.

imageKey
String

Clave de la imagen que se va a mostrar para el elemento.

Devoluciones

ListViewItem

ListViewItem agregado a la colección.

Excepciones

El parámetro index es menor que cero o mayor que el valor de la propiedad Count de ListView.ListViewItemCollection.

Se aplica a

Insert(Int32, ListViewItem)

Inserta un ListViewItem existente en el índice especificado de la colección.

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::Windows::Forms::ListViewItem ^ item);
public System.Windows.Forms.ListViewItem Insert (int index, System.Windows.Forms.ListViewItem item);
member this.Insert : int * System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem
Public Function Insert (index As Integer, item As ListViewItem) As ListViewItem

Parámetros

index
Int32

Ubicación del índice de base cero donde se inserta el elemento.

item
ListViewItem

ListViewItem que representa el elemento que se va a insertar.

Devoluciones

ListViewItem

ListViewItem insertado en la colección.

Excepciones

El parámetro index es menor que cero o mayor que el valor de la propiedad Count de ListView.ListViewItemCollection.

Comentarios

Esta versión del Insert método permite insertar un existente ListViewItem en una posición específica en .ListView.ListViewItemCollection

Nota

Si la ListView.Sorting propiedad se establece en un valor distinto SortOrder.None de o si se establece la ListViewItemSorter propiedad, la lista se ordena después de insertar el elemento.

Para agregar un elemento sin especificar una posición específica en la colección para agregar el elemento, use el Add método . Si desea agregar una matriz de elementos a la colección, use el AddRange método . Puede usar este método si desea insertar un nuevo elemento en una colección de elementos existente.

Consulte también

Se aplica a

Insert(Int32, String)

Crea un nuevo elemento y lo inserta en la colección, en el índice especificado.

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text);
public System.Windows.Forms.ListViewItem Insert (int index, string text);
member this.Insert : int * string -> System.Windows.Forms.ListViewItem
Public Function Insert (index As Integer, text As String) As ListViewItem

Parámetros

index
Int32

Ubicación del índice de base cero donde se inserta el elemento.

text
String

Texto que se va a mostrar para el elemento.

Devoluciones

ListViewItem

ListViewItem insertado en la colección.

Excepciones

El parámetro index es menor que cero o mayor que el valor de la propiedad Count de ListView.ListViewItemCollection.

Comentarios

Esta versión del Insert método permite insertar un nuevo elemento en una posición específica de .ListView.ListViewItemCollection El texto especificado en el text parámetro se usa para crear un nuevo ListViewItem objeto que se inserta en en la ListView.ListViewItemCollection ubicación especificada.

Nota

Si la ListView.Sorting propiedad se establece en un valor distinto SortOrder.None de o si se establece la ListViewItemSorter propiedad, la lista se ordena después de insertar el elemento.

Para agregar un elemento sin especificar una posición específica en la colección, use el Add método . Si desea agregar una matriz de elementos a la colección, use el AddRange método . Puede usar este método si desea insertar un nuevo elemento en una colección de elementos existente.

Consulte también

Se aplica a

Insert(Int32, String, Int32)

Crea un nuevo elemento con el índice de imágenes especificado y lo inserta en la colección, en el índice especificado.

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text, int imageIndex);
public System.Windows.Forms.ListViewItem Insert (int index, string text, int imageIndex);
member this.Insert : int * string * int -> System.Windows.Forms.ListViewItem
Public Function Insert (index As Integer, text As String, imageIndex As Integer) As ListViewItem

Parámetros

index
Int32

Ubicación del índice de base cero donde se inserta el elemento.

text
String

Texto que se va a mostrar para el elemento.

imageIndex
Int32

Índice de la imagen que se va a mostrar para el elemento.

Devoluciones

ListViewItem

ListViewItem insertado en la colección.

Excepciones

El parámetro index es menor que cero o mayor que el valor de la propiedad Count de ListView.ListViewItemCollection.

Comentarios

Esta versión del Insert método permite insertar un nuevo elemento en una posición específica de .ListView.ListViewItemCollection El texto especificado en el text parámetro se usa para crear un nuevo ListViewItem objeto que se inserta en en la ListView.ListViewItemCollection ubicación especificada.

Nota

Si la ListView.Sorting propiedad se establece en un valor distinto SortOrder.None de o si se establece la ListViewItemSorter propiedad, la lista se ordena después de insertar el elemento.

También puede usar esta versión del Insert método para especificar una imagen para el elemento pasando el índice del ImageList asignado a las ListView.LargeImageList propiedades y ListView.SmallImageList al imageIndex parámetro . (Normalmente, las ListView.LargeImageList propiedades y ListView.SmallImageList usan las mismas posiciones de índice para mostrar imágenes relacionadas). Si no desea especificar un índice de imagen para el elemento, use la otra versión del Insert método que acepta una cadena como parámetro.

Para agregar un elemento sin especificar una posición específica en la colección, use el Add método . Si desea agregar una matriz de elementos a la colección, use el AddRange método .

Consulte también

Se aplica a