ListView.ListViewItemCollection.Insert Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Inserta un elemento en la colección en el índice especificado.
Sobrecargas
| Nombre | Description |
|---|---|
| Insert(Int32, String, String, String) |
Crea un nuevo elemento con la clave, el texto y la imagen especificados y lo agrega a la colección en el índice especificado. |
| Insert(Int32, String, String, Int32) |
Crea un nuevo elemento con la clave, el texto y la imagen especificados y lo inserta en la colección en el índice especificado. |
| Insert(Int32, String, String) |
Crea un nuevo elemento con el texto y la imagen especificados y lo inserta en la colección en el índice especificado. |
| Insert(Int32, ListViewItem) |
Inserta un existente ListViewItem en la colección en el índice especificado. |
| Insert(Int32, String) |
Crea un nuevo elemento e lo inserta en la colección en el índice especificado. |
| Insert(Int32, String, Int32) |
Crea un nuevo elemento con el índice de imagen especificado e lo inserta en la colección en el índice especificado. |
Insert(Int32, String, String, String)
Crea un nuevo elemento con la clave, el texto y la imagen especificados 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);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.ListViewItemPublic Overridable Function Insert (index As Integer, key As String, text As String, imageKey As String) As ListViewItemParámetros
- index
- Int32
Ubicación del índice de base cero donde se inserta el elemento.
- text
- String
Texto del elemento.
- imageKey
- String
Clave de la imagen que se va a mostrar para el elemento.
Devoluciones
que ListViewItem se ha agregado a la colección.
Excepciones
El index parámetro es menor que 0 o mayor que el valor de la Count propiedad 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 la clave, el texto y la imagen especificados 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);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.ListViewItemPublic Overridable Function Insert (index As Integer, key As String, text As String, imageIndex As Integer) As ListViewItemParámetros
- index
- Int32
Ubicación del índice de base cero donde se inserta el elemento.
- text
- String
Texto del elemento.
- imageIndex
- Int32
Índice de la imagen que se va a mostrar para el elemento.
Devoluciones
que ListViewItem se ha agregado a la colección.
Excepciones
El index parámetro es menor que 0 o mayor que el valor de la Count propiedad 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 el texto y la imagen 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);public System.Windows.Forms.ListViewItem Insert(int index, string? text, string? imageKey);member this.Insert : int * string * string -> System.Windows.Forms.ListViewItemPublic Function Insert (index As Integer, text As String, imageKey As String) As ListViewItemParámetros
- index
- Int32
Ubicación del índice de base cero donde se inserta el elemento.
- text
- String
Texto de .ListViewItem
- imageKey
- String
Clave de la imagen que se va a mostrar para el elemento.
Devoluciones
que ListViewItem se ha agregado a la colección.
Excepciones
El index parámetro es menor que 0 o mayor que el valor de la Count propiedad de ListView.ListViewItemCollection.
Se aplica a
Insert(Int32, ListViewItem)
Inserta un existente ListViewItem en la colección en el índice especificado.
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.ListViewItemPublic Function Insert (index As Integer, item As ListViewItem) As ListViewItemPará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
que ListViewItem se insertó en la colección.
Excepciones
El index parámetro es menor que 0 o mayor que el valor de la Count propiedad 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 e 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);public System.Windows.Forms.ListViewItem Insert(int index, string? text);member this.Insert : int * string -> System.Windows.Forms.ListViewItemPublic Function Insert (index As Integer, text As String) As ListViewItemPará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
que ListViewItem se insertó en la colección.
Excepciones
El index parámetro es menor que 0 o mayor que el valor de la Count propiedad de ListView.ListViewItemCollection.
Comentarios
Esta versión del Insert método permite insertar un nuevo elemento en una posición específica en .ListView.ListViewItemCollection El texto especificado en el text parámetro se usa para crear un nuevo ListViewItem elemento que, a continuación, 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 imagen especificado e 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);public System.Windows.Forms.ListViewItem Insert(int index, string? text, int imageIndex);member this.Insert : int * string * int -> System.Windows.Forms.ListViewItemPublic Function Insert (index As Integer, text As String, imageIndex As Integer) As ListViewItemPará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
que ListViewItem se insertó en la colección.
Excepciones
El index parámetro es menor que 0 o mayor que el valor de la Count propiedad de ListView.ListViewItemCollection.
Comentarios
Esta versión del Insert método permite insertar un nuevo elemento en una posición específica en .ListView.ListViewItemCollection El texto especificado en el text parámetro se usa para crear un nuevo ListViewItem elemento que, a continuación, 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 .
