ListView.ListViewItemCollection.Add Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Agrega un elemento a la colección de elementos.

Sobrecargas

Nombre	Description
Add(String)	Crea un elemento con el texto especificado y lo agrega a la colección.
Add(ListViewItem)	Agrega un existente ListViewItem a la colección.
Add(String, Int32)	Crea un elemento con el texto y la imagen especificados y lo agrega a la colección.
Add(String, String)	Crea un elemento con el texto y la imagen especificados y lo agrega a la colección.
Add(String, String, Int32)	Crea un elemento con la clave, el texto y la imagen especificados y agrega un elemento a la colección.
Add(String, String, String)	Crea un elemento con la clave, el texto y la imagen especificados y lo agrega a la colección.

Add(String)

Source:

ListView.ListViewItemCollection.cs

Crea un elemento con el texto especificado y lo agrega a la colección.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text);

public virtual System.Windows.Forms.ListViewItem Add(string? text);

abstract member Add : string -> System.Windows.Forms.ListViewItem
override this.Add : string -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (text As String) As ListViewItem

Parámetros

text

String

Texto que se va a mostrar para el elemento.

Devoluciones

ListViewItem

que ListViewItem se agregó a la colección.

Comentarios

Puede usar esta versión del Add método para crear un nuevo ListViewItem para agregar a un ListView control . El texto del nuevo ListViewItem agregado al control se basa en el text parámetro . Si desea especificar una imagen para el elemento, use la versión del Add método que acepta un índice de imagen como parámetro. Si tiene un ListViewItem existente que desea agregar a la colección, use la versión del Add método que acepta como ListViewItem parámetro .

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 agregar el elemento. De lo contrario, el elemento se inserta al final de la lista. Si la lista no está ordenada, puede usar el Insert método para insertar un elemento en una ListView posición específica. Para agregar un conjunto de elementos al control en una sola operación, use el AddRange método . Si desea usar el Add método para agregar un gran número de elementos al control, use los BeginUpdate métodos y EndUpdate para evitar ListView que se vuelva a pintar hasta que se agreguen todos los elementos. Al agregar elementos a , ListViewes más eficaz ordenar primero los elementos y, a continuación, agregar nuevos elementos.

Consulte también

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

Add(ListViewItem)

Source:

ListView.ListViewItemCollection.cs

Agrega un existente ListViewItem a la colección.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::Windows::Forms::ListViewItem ^ value);

public virtual System.Windows.Forms.ListViewItem Add(System.Windows.Forms.ListViewItem value);

abstract member Add : System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem
override this.Add : System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (value As ListViewItem) As ListViewItem

Parámetros

value

ListViewItem

que ListViewItem se va a agregar a la colección.

Devoluciones

ListViewItem

que ListViewItem se agregó a la colección.

Comentarios

Puede usar esta versión del Add método para agregar un existente ListViewItem a la colección. Esta versión del Add método se usa normalmente para reutilizar elementos de otros ListView controles o si ListViewItem se creó manualmente antes de agregarlo a la colección. Si desea crear un nuevo ListViewItem en lugar de usar un elemento existente, use las otras versiones del Add método .

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 agregar el elemento. De lo contrario, el elemento se inserta al final de la lista. Si la lista no está ordenada, puede usar el Insert método para insertar un elemento en una ListView posición específica. Para agregar un conjunto de elementos al control en una sola operación, use el AddRange método . Si desea usar el Add método para agregar un gran número de elementos al control, use los BeginUpdate métodos y EndUpdate para evitar ListView que se vuelva a pintar hasta que se agreguen todos los elementos. Al agregar elementos a , ListViewes más eficaz ordenar primero los elementos y, a continuación, agregar nuevos elementos.

Esta versión del Add método también se usa para asignar un ListViewItem objeto a .ListViewGroup

Consulte también

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

Add(String, Int32)

Source:

ListView.ListViewItemCollection.cs

Crea un elemento con el texto y la imagen especificados y lo agrega a la colección.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text, int imageIndex);

public virtual System.Windows.Forms.ListViewItem Add(string? text, int imageIndex);

abstract member Add : string * int -> System.Windows.Forms.ListViewItem
override this.Add : string * int -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (text As String, imageIndex As Integer) As ListViewItem

Parámetros

text

String

Texto del elemento.

imageIndex

Int32

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

Devoluciones

ListViewItem

que ListViewItem se agregó a la colección.

Comentarios

Puede usar esta versión del Add método para crear un nuevo ListViewItem para agregar al ListView control . El texto del nuevo ListViewItem agregado al control se basa en el text parámetro . También puede 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 versión del Add método que acepta solo una cadena como parámetro. Si tiene un ListViewItem existente que desea agregar a la colección, use la versión del Add método que acepta como ListViewItem parámetro .

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 agregar el elemento. De lo contrario, el elemento se inserta al final de la lista. Si la lista no está ordenada, puede usar el Insert método para insertar un elemento en una ListView posición específica. Para agregar un conjunto de elementos al control en una sola operación, use el AddRange método . Si desea usar el Add método para agregar un gran número de elementos al control, use los BeginUpdate métodos y EndUpdate para evitar ListView que se vuelva a pintar hasta que se agreguen todos los elementos. Al agregar elementos a , ListViewes más eficaz ordenar primero los elementos y, a continuación, agregar nuevos elementos.

Consulte también

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

Add(String, String)

Source:

ListView.ListViewItemCollection.cs

Crea un elemento con el texto y la imagen especificados y lo agrega a la colección.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text, System::String ^ imageKey);

public virtual System.Windows.Forms.ListViewItem Add(string? text, string? imageKey);

abstract member Add : string * string -> System.Windows.Forms.ListViewItem
override this.Add : string * string -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (text As String, imageKey As String) As ListViewItem

Parámetros

text

String

Texto del elemento.

imageKey

String

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

Devoluciones

ListViewItem

que ListViewItem se ha agregado a la colección.

Comentarios

ListView Si se ordena , el elemento se agrega en el orden ordenado correctamente; de lo contrario, se agrega al final de la colección.

Add(String, String, Int32)

Source:

ListView.ListViewItemCollection.cs

Crea un elemento con la clave, el texto y la imagen especificados y agrega un elemento a la colección.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ key, System::String ^ text, int imageIndex);

public virtual System.Windows.Forms.ListViewItem Add(string? key, string? text, int imageIndex);

abstract member Add : string * string * int -> System.Windows.Forms.ListViewItem
override this.Add : string * string * int -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (key As String, text As String, imageIndex As Integer) As ListViewItem

Parámetros

key

String

Nombre del artículo.

text

String

Texto del elemento.

imageIndex

Int32

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

Devoluciones

ListViewItem

que ListViewItem se ha agregado a la colección.

Excepciones

InvalidOperationException

El contenedor ListView está en modo virtual.

Comentarios

ListView Si se ordena , el elemento se agrega en el orden ordenado correctamente; de lo contrario, se agrega al final de la colección. La Name propiedad corresponde a la clave de en ListViewItem .ListView.ListViewItemCollection

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

Add(String, String, String)

Source:

ListView.ListViewItemCollection.cs

Crea un elemento con la clave, el texto y la imagen especificados y lo agrega a la colección.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ key, System::String ^ text, System::String ^ imageKey);

public virtual System.Windows.Forms.ListViewItem Add(string? key, string? text, string? imageKey);

abstract member Add : string * string * string -> System.Windows.Forms.ListViewItem
override this.Add : string * string * string -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (key As String, text As String, imageKey As String) As ListViewItem

Parámetros

key

String

Nombre del artículo.

text

String

Texto del elemento.

imageKey

String

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

Devoluciones

ListViewItem

que ListViewItem se ha agregado a la colección.

Comentarios

La Name propiedad corresponde a la clave de en ListViewItem .ListView.ListViewItemCollection

ListView Si se ordena , el elemento se agrega en el orden ordenado correctamente; de lo contrario, se agrega al final de la colección. El Add 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.