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 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.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
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.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
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.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
El texto del ListViewItem.
- imageKey
- String
Clave de la imagen que se va a mostrar para el elemento.
Devoluciones
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.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
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.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
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.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
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 .