ListView.ListViewItemCollection.Add Metodo

Definizione

Aggiunge un elemento all'insieme.Adds an item to the collection of items.

Overload

Add(String)

Crea un elemento con il testo specificato e lo aggiunge all'insieme.Creates an item with the specified text and adds it to the collection.

Add(ListViewItem)

Aggiunge un oggetto ListViewItem esistente all'insieme.Adds an existing ListViewItem to the collection.

Add(String, Int32)

Crea un elemento con il testo e l'immagine specificati e lo aggiunge all'insieme.Creates an item with the specified text and image and adds it to the collection.

Add(String, String)

Crea un elemento con il testo e l'immagine specificati e lo aggiunge all'insieme.Creates an item with the specified text and image and adds it to the collection.

Add(String, String, Int32)

Crea un elemento con la chiave, il testo e l'immagine specificati e aggiunge un elemento all'insieme.Creates an item with the specified key, text, and image and adds an item to the collection.

Add(String, String, String)

Crea un elemento con la chiave, il testo e l'immagine specificati e lo aggiunge all'insieme.Creates an item with the specified key, text, and image, and adds it to the collection.

Add(String)

Crea un elemento con il testo specificato e lo aggiunge all'insieme.Creates an item with the specified text and adds it to the collection.

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

Parametri

text
String

Testo da visualizzare per l'elemento.The text to display for the item.

Restituisce

ListViewItem

ListViewItem aggiunto all'insieme.The ListViewItem that was added to the collection.

Commenti

È possibile utilizzare questa versione del Add metodo per creare un nuovo oggetto ListViewItem da aggiungere a un ListView controllo.You can use this version of the Add method to create a new ListViewItem to add to a ListView control. Il testo del nuovo oggetto ListViewItem aggiunto al controllo è basato sul text parametro.The text of the new ListViewItem added to the control is based on the text parameter. Se si desidera specificare un'immagine per l'elemento, utilizzare la versione del Add metodo che accetta un indice di immagine come parametro.If you want to specify an image for the item, use the version of the Add method that accepts an image index as a parameter. Se è presente un oggetto ListViewItem che si desidera aggiungere alla raccolta, utilizzare la versione del Add metodo che accetta ListViewItem come parametro.If you have an existing ListViewItem that you want to add to the collection, use the version of the Add method that accepts a ListViewItem as its parameter.

Se la ListView.Sorting proprietà è impostata su un valore diverso da SortOrder.None o se la ListViewItemSorter proprietà è impostata, l'elenco viene ordinato dopo l'aggiunta dell'elemento.If the ListView.Sorting property is set to a value other than SortOrder.None or if the ListViewItemSorter property is set, the list is sorted after the item is added. In caso contrario, l'elemento viene inserito alla fine dell'elenco.Otherwise, the item is inserted at the end of the list. Se l'elenco non è ordinato, è possibile usare il Insert metodo per inserire un elemento in ListView una posizione specifica.If the list is not sorted, you can use the Insert method to insert an item into the ListView at a specific position. Per aggiungere un set di elementi al controllo in un'unica operazione, utilizzare il AddRange metodo.To add a set of items to the control in a single operation, use the AddRange method. Se si desidera utilizzare il Add metodo per aggiungere un numero elevato di elementi al controllo, utilizzare i BeginUpdate EndUpdate metodi e per impedire che il ListView ridisegno venga ridisegnato fino a quando non vengono aggiunti tutti gli elementi.If you want to use the Add method to add a large number of items to the control, use the BeginUpdate and EndUpdate methods to prevent the ListView from repainting until all items are added. Quando si aggiungono elementi a un oggetto ListView , è più efficiente ordinare prima gli elementi e quindi aggiungere nuovi elementi.When adding items to a ListView, it is more efficient to sort the items first and then add new items.

Vedi anche

Si applica a

Add(ListViewItem)

Aggiunge un oggetto ListViewItem esistente all'insieme.Adds an existing ListViewItem to the collection.

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

Parametri

value
ListViewItem

Oggetto ListViewItem da aggiungere alla raccolta.The ListViewItem to add to the collection.

Restituisce

ListViewItem

ListViewItem aggiunto all'insieme.The ListViewItem that was added to the collection.

Commenti

È possibile utilizzare questa versione del Add metodo per aggiungere un oggetto esistente ListViewItem alla raccolta.You can use this version of the Add method to add an existing ListViewItem to the collection. Questa versione del Add metodo viene in genere utilizzata per riutilizzare gli elementi di altri ListView controlli o se ListViewItem è stato creato manualmente prima di aggiungerlo alla raccolta.This version of the Add method is typically used to reuse items from other ListView controls or if the ListViewItem was created manually before adding it to the collection. Se si desidera creare un nuovo ListViewItem anziché utilizzare un elemento esistente, utilizzare le altre versioni del Add metodo.If you want to create a new ListViewItem instead of using an existing item, use the other versions of the Add method.

Se la ListView.Sorting proprietà è impostata su un valore diverso da SortOrder.None o se la ListViewItemSorter proprietà è impostata, l'elenco viene ordinato dopo l'aggiunta dell'elemento.If the ListView.Sorting property is set to a value other than SortOrder.None or if the ListViewItemSorter property is set, the list is sorted after the item is added. In caso contrario, l'elemento viene inserito alla fine dell'elenco.Otherwise, the item is inserted at the end of the list. Se l'elenco non è ordinato, è possibile usare il Insert metodo per inserire un elemento in ListView una posizione specifica.If the list is not sorted, you can use the Insert method to insert an item into the ListView at a specific position. Per aggiungere un set di elementi al controllo in un'unica operazione, utilizzare il AddRange metodo.To add a set of items to the control in a single operation, use the AddRange method. Se si desidera utilizzare il Add metodo per aggiungere un numero elevato di elementi al controllo, utilizzare i BeginUpdate EndUpdate metodi e per impedire che il ListView ridisegno venga ridisegnato fino a quando non vengono aggiunti tutti gli elementi.If you want to use the Add method to add a large number of items to the control, use the BeginUpdate and EndUpdate methods to prevent the ListView from repainting until all items are added. Quando si aggiungono elementi a un oggetto ListView , è più efficiente ordinare prima gli elementi e quindi aggiungere nuovi elementi.When adding items to a ListView, it is more efficient to sort the items first and then add new items.

Questa versione del Add metodo viene usata anche per assegnare un oggetto ListViewItem a un oggetto ListViewGroup .This version of the Add method is also used to assign a ListViewItem to a ListViewGroup.

Vedi anche

Si applica a

Add(String, Int32)

Crea un elemento con il testo e l'immagine specificati e lo aggiunge all'insieme.Creates an item with the specified text and image and adds it to the collection.

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

Parametri

text
String

Testo dell'elemento.The text of the item.

imageIndex
Int32

Indice dell'immagine associata all'elemento.The index of the image to display for the item.

Restituisce

ListViewItem

ListViewItem aggiunto all'insieme.The ListViewItem that was added to the collection.

Commenti

È possibile utilizzare questa versione del Add metodo per creare un nuovo oggetto ListViewItem da aggiungere al ListView controllo.You can use this version of the Add method to create a new ListViewItem to add to the ListView control. Il testo del nuovo oggetto ListViewItem aggiunto al controllo è basato sul text parametro.The text of the new ListViewItem added to the control is based on the text parameter. È anche possibile specificare un'immagine per l'elemento passando l'indice dell'oggetto ImageList assegnato alle ListView.LargeImageList ListView.SmallImageList proprietà e al imageIndex parametro.You can also specify an image for the item by passing the index of the ImageList assigned to the ListView.LargeImageList and ListView.SmallImageList properties to the imageIndex parameter. In genere, le ListView.LargeImageList ListView.SmallImageList proprietà e utilizzano le stesse posizioni di indice per visualizzare le immagini correlate. Se non si desidera specificare un indice di immagine per l'elemento, utilizzare la versione del Add metodo che accetta solo una stringa come parametro.(Typically, the ListView.LargeImageList and ListView.SmallImageList properties use the same index positions to display related images.) If you do not want to specify an image index for the item, use the version of the Add method that accepts only a string as a parameter. Se è presente un oggetto ListViewItem che si desidera aggiungere alla raccolta, utilizzare la versione del Add metodo che accetta ListViewItem come parametro.If you have an existing ListViewItem that you want to add to the collection, use the version of the Add method that accepts a ListViewItem as its parameter.

Se la ListView.Sorting proprietà è impostata su un valore diverso da SortOrder.None o se la ListViewItemSorter proprietà è impostata, l'elenco viene ordinato dopo l'aggiunta dell'elemento.If the ListView.Sorting property is set to a value other than SortOrder.None or if the ListViewItemSorter property is set, the list is sorted after the item is added. In caso contrario, l'elemento viene inserito alla fine dell'elenco.Otherwise, the item is inserted at the end of the list. Se l'elenco non è ordinato, è possibile usare il Insert metodo per inserire un elemento in ListView una posizione specifica.If the list is not sorted, you can use the Insert method to insert an item into the ListView at a specific position. Per aggiungere un set di elementi al controllo in un'unica operazione, utilizzare il AddRange metodo.To add a set of items to the control in a single operation, use the AddRange method. Se si desidera utilizzare il Add metodo per aggiungere un numero elevato di elementi al controllo, utilizzare i BeginUpdate EndUpdate metodi e per impedire che il ListView ridisegno venga ridisegnato fino a quando non vengono aggiunti tutti gli elementi.If you want to use the Add method to add a large number of items to the control, use the BeginUpdate and EndUpdate methods to prevent the ListView from repainting until all items are added. Quando si aggiungono elementi a un oggetto ListView , è più efficiente ordinare prima gli elementi e quindi aggiungere nuovi elementi.When adding items to a ListView, it is more efficient to sort the items first and then add new items.

Vedi anche

Si applica a

Add(String, String)

Crea un elemento con il testo e l'immagine specificati e lo aggiunge all'insieme.Creates an item with the specified text and image and adds it to the collection.

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

Parametri

text
String

Testo dell'elemento.The text of the item.

imageKey
String

Chiave dell'immagine da visualizzare per l'elemento.The key of the image to display for the item.

Restituisce

ListViewItem

ListViewItem aggiunto all'insieme.The ListViewItem added to the collection.

Commenti

Se ListView è ordinato, l'elemento viene aggiunto nell'ordine correttamente ordinato; in caso contrario, viene aggiunto alla fine della raccolta.If the ListView is sorted, the item is added in the correctly sorted order; otherwise, it is added to the end of the collection.

Si applica a

Add(String, String, Int32)

Crea un elemento con la chiave, il testo e l'immagine specificati e aggiunge un elemento all'insieme.Creates an item with the specified key, text, and image and adds an item to the collection.

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

Parametri

key
String

Nome dell'elemento.The name of the item.

text
String

Testo dell'elemento.The text of the item.

imageIndex
Int32

Indice dell'immagine associata all'elemento.The index of the image to display for the item.

Restituisce

ListViewItem

ListViewItem aggiunto all'insieme.The ListViewItem added to the collection.

Eccezioni

L'oggetto ListView contenente è in modalità virtuale.The containing ListView is in virtual mode.

Commenti

Se ListView è ordinato, l'elemento viene aggiunto nell'ordine correttamente ordinato; in caso contrario, viene aggiunto alla fine della raccolta.If the ListView is sorted, the item is added in the correctly sorted order; otherwise, it is added to the end of the collection. La Name proprietà corrisponde alla chiave per un oggetto ListViewItem in ListView.ListViewItemCollection .The Name property corresponds to the key for a ListViewItem in the ListView.ListViewItemCollection.

Il Add metodo imposta la Name proprietà sulla chiave specificata, in modo che l'elemento possa essere recuperato in base al relativo indice o alla chiave.The Add method sets the Name property to the specified key, so the item can be retrieved by its index or by key.

Si applica a

Add(String, String, String)

Crea un elemento con la chiave, il testo e l'immagine specificati e lo aggiunge all'insieme.Creates an item with the specified key, text, and image, and adds it to the collection.

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

Parametri

key
String

Nome dell'elemento.The name of the item.

text
String

Testo dell'elemento.The text of the item.

imageKey
String

Chiave dell'immagine da visualizzare per l'elemento.The key of the image to display for the item.

Restituisce

ListViewItem

ListViewItem aggiunto all'insieme.The ListViewItem added to the collection.

Commenti

La Name proprietà corrisponde alla chiave per un oggetto ListViewItem in ListView.ListViewItemCollection .The Name property corresponds to the key for a ListViewItem in the ListView.ListViewItemCollection.

Se ListView è ordinato, l'elemento viene aggiunto nell'ordine correttamente ordinato; in caso contrario, viene aggiunto alla fine della raccolta.If the ListView is sorted, the item is added in the correctly sorted order; otherwise, it is added to the end of the collection. Il Add metodo imposta la Name proprietà dell'elemento sulla chiave specificata, in modo che l'elemento possa essere recuperato in base al relativo indice o alla chiave.The Add method sets the Name property of the item to the specified key, so the item can be retrieved by its index or by key.

Si applica a