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

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

Add(String)

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

ListViewItem que 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 existente ListViewItem que desea agregar a la colección, use la versión del Add método que acepta un ListViewItem como 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 que ListView se vuelva a pintar hasta que se agreguen todos los elementos. Al agregar elementos a , ListViewes más eficaz ordenar los elementos primero y, a continuación, agregar nuevos elementos.

Consulte también

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

Add(ListViewItem)

Agrega un objeto ListViewItem existente 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

ListViewItem que se agrega a la colección.

Devoluciones

ListViewItem

ListViewItem que se agregó a la colección.

Comentarios

Puede usar esta versión del Add método para agregar una 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 que ListView se vuelva a pintar hasta que se agreguen todos los elementos. Al agregar elementos a , ListViewes más eficaz ordenar los elementos primero 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)

Crea un elemento con la imagen y el texto 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

ListViewItem que 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 existente ListViewItem que desea agregar a la colección, use la versión del Add método que acepta un ListViewItem como 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 que ListView se vuelva a pintar hasta que se agreguen todos los elementos. Al agregar elementos a , ListViewes más eficaz ordenar los elementos primero y, a continuación, agregar nuevos elementos.

Consulte también

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

Add(String, String)

Crea un elemento con la imagen y el texto 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

ListViewItem 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)

Crea un elemento con el texto, la clave y la imagen especificadas y lo agrega 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 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

InvalidOperationException

La ListView que contiene 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)

Crea un elemento con el texto, la clave 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 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.

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.