ListView.ListViewItemCollection.Insert Metodo

Definizione

Inserisce un elemento nella raccolta in corrispondenza dell'indice specificato.Inserts an item into the collection at the specified index.

Overload

Insert(Int32, String, String, String)

Crea un nuovo elemento con la chiave, il testo e l'immagine indicati e lo aggiunge all'insieme in corrispondenza dell'indice specificato.Creates a new item with the specified key, text, and image, and adds it to the collection at the specified index.

Insert(Int32, String, String, Int32)

Crea un nuovo elemento con la chiave, il testo e l'immagine indicati e lo inserisce nell'insieme in corrispondenza dell'indice specificato.Creates a new item with the specified key, text, and image, and inserts it in the collection at the specified index.

Insert(Int32, String, String)

Crea un nuovo elemento con il testo e l'immagine specificati e lo inserisce nell'insieme in corrispondenza dell'indice specificato.Creates a new item with the specified text and image and inserts it in the collection at the specified index.

Insert(Int32, ListViewItem)

Inserisce nell'insieme un oggetto ListViewItem esistente in corrispondenza dell'indice specificato.Inserts an existing ListViewItem into the collection at the specified index.

Insert(Int32, String)

Crea un nuovo elemento e lo inserisce nell'insieme in corrispondenza dell'indice specificato.Creates a new item and inserts it into the collection at the specified index.

Insert(Int32, String, Int32)

Crea un nuovo elemento con l'indice di immagine specificato e lo inserisce nell'insieme in corrispondenza dell'indice specificato.Creates a new item with the specified image index and inserts it into the collection at the specified index.

Insert(Int32, String, String, String)

Crea un nuovo elemento con la chiave, il testo e l'immagine indicati e lo aggiunge all'insieme in corrispondenza dell'indice specificato.Creates a new item with the specified key, text, and image, and adds it to the collection at the specified index.

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.ListViewItem
Public Overridable Function Insert (index As Integer, key As String, text As String, imageKey As String) As ListViewItem

Parametri

index
Int32

Posizione dell'indice in base zero in corrispondenza della quale viene inserito l'elemento.The zero-based index location where the item is inserted.

key
String

Proprietà Name 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.

Eccezioni

Il parametro index è minore di 0 o maggiore del valore della proprietà Count dell'oggetto ListView.ListViewItemCollection.The index parameter is less than 0 or greater than the value of the Count property of the ListView.ListViewItemCollection.

Commenti

Il Insert 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 Insert 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

Insert(Int32, String, String, Int32)

Crea un nuovo elemento con la chiave, il testo e l'immagine indicati e lo inserisce nell'insieme in corrispondenza dell'indice specificato.Creates a new item with the specified key, text, and image, and inserts it in the collection at the specified index.

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.ListViewItem
Public Overridable Function Insert (index As Integer, key As String, text As String, imageIndex As Integer) As ListViewItem

Parametri

index
Int32

Posizione dell'indice in base zero in corrispondenza della quale inserire l'elementoThe zero-based index location where the item is inserted

key
String

Proprietà Name 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

Il parametro index è minore di 0 o maggiore del valore della proprietà Count dell'oggetto ListView.ListViewItemCollection.The index parameter is less than 0 or greater than the value of the Count property of the ListView.ListViewItemCollection.

Commenti

Il Insert 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 Insert 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

Insert(Int32, String, String)

Crea un nuovo elemento con il testo e l'immagine specificati e lo inserisce nell'insieme in corrispondenza dell'indice specificato.Creates a new item with the specified text and image and inserts it in the collection at the specified index.

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.ListViewItem
Public Function Insert (index As Integer, text As String, imageKey As String) As ListViewItem

Parametri

index
Int32

Posizione dell'indice in base zero in corrispondenza della quale viene inserito l'elemento.The zero-based index location where the item is inserted.

text
String

Testo di ListViewItem.The text of the ListViewItem.

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.

Eccezioni

Il parametro index è minore di 0 o maggiore del valore della proprietà Count dell'oggetto ListView.ListViewItemCollection.The index parameter is less than 0 or greater than the value of the Count property of the ListView.ListViewItemCollection.

Si applica a

Insert(Int32, ListViewItem)

Inserisce nell'insieme un oggetto ListViewItem esistente in corrispondenza dell'indice specificato.Inserts an existing ListViewItem into the collection at the specified index.

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.ListViewItem
Public Function Insert (index As Integer, item As ListViewItem) As ListViewItem

Parametri

index
Int32

Posizione dell'indice in base zero in corrispondenza della quale viene inserito l'elemento.The zero-based index location where the item is inserted.

item
ListViewItem

Oggetto ListViewItem che rappresenta l'elemento da inserire.The ListViewItem that represents the item to insert.

Restituisce

ListViewItem

Oggetto ListViewItem inserito nell'insieme.The ListViewItem that was inserted into the collection.

Eccezioni

Il parametro index è minore di 0 o maggiore del valore della proprietà Count dell'oggetto ListView.ListViewItemCollection.The index parameter is less than 0 or greater than the value of the Count property of the ListView.ListViewItemCollection.

Commenti

Questa versione del Insert metodo consente di inserire un oggetto esistente in ListViewItem una posizione specifica nell'oggetto ListView.ListViewItemCollection .This version of the Insert method allows you to insert an existing ListViewItem at a specific position in the ListView.ListViewItemCollection.

Nota

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'inserimento 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 inserted.

Per aggiungere un elemento senza specificare una posizione specifica nella raccolta per aggiungere l'elemento, usare il Add metodo.To add an item without specifying a specific position in the collection to add the item, use the Add method. Se si desidera aggiungere una matrice di elementi alla raccolta, utilizzare il AddRange metodo.If you want to add an array of items to the collection, use the AddRange method. È possibile utilizzare questo metodo se si desidera inserire un nuovo elemento in una raccolta esistente di elementi.You can use this method if you want to insert a new item into an existing collection of items.

Vedi anche

Si applica a

Insert(Int32, String)

Crea un nuovo elemento e lo inserisce nell'insieme in corrispondenza dell'indice specificato.Creates a new item and inserts it into the collection at the specified index.

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.ListViewItem
Public Function Insert (index As Integer, text As String) As ListViewItem

Parametri

index
Int32

Posizione dell'indice in base zero in corrispondenza della quale viene inserito l'elemento.The zero-based index location where the item is inserted.

text
String

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

Restituisce

ListViewItem

Oggetto ListViewItem inserito nell'insieme.The ListViewItem that was inserted into the collection.

Eccezioni

Il parametro index è minore di 0 o maggiore del valore della proprietà Count dell'oggetto ListView.ListViewItemCollection.The index parameter is less than 0 or greater than the value of the Count property of the ListView.ListViewItemCollection.

Commenti

Questa versione del Insert metodo consente di inserire un nuovo elemento in una posizione specifica nell'oggetto ListView.ListViewItemCollection .This version of the Insert method allows you to insert a new item at a specific position in the ListView.ListViewItemCollection. Il testo specificato nel text parametro viene usato per creare un nuovo oggetto ListViewItem che viene quindi inserito nell'oggetto nella ListView.ListViewItemCollection posizione specificata.The text specified in the text parameter is used to create a new ListViewItem that is then inserted into the ListView.ListViewItemCollection at the specified location.

Nota

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'inserimento 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 inserted.

Per aggiungere un elemento senza specificare una posizione specifica nella raccolta, utilizzare il Add metodo.To add an item without specifying a specific position in the collection, use the Add method. Se si desidera aggiungere una matrice di elementi alla raccolta, utilizzare il AddRange metodo.If you want to add an array of items to the collection, use the AddRange method. È possibile utilizzare questo metodo se si desidera inserire un nuovo elemento in una raccolta esistente di elementi.You can use this method if you want to insert a new item into an existing collection of items.

Vedi anche

Si applica a

Insert(Int32, String, Int32)

Crea un nuovo elemento con l'indice di immagine specificato e lo inserisce nell'insieme in corrispondenza dell'indice specificato.Creates a new item with the specified image index and inserts it into the collection at the specified index.

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.ListViewItem
Public Function Insert (index As Integer, text As String, imageIndex As Integer) As ListViewItem

Parametri

index
Int32

Posizione dell'indice in base zero in corrispondenza della quale viene inserito l'elemento.The zero-based index location where the item is inserted.

text
String

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

imageIndex
Int32

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

Restituisce

ListViewItem

Oggetto ListViewItem inserito nell'insieme.The ListViewItem that was inserted into the collection.

Eccezioni

Il parametro index è minore di 0 o maggiore del valore della proprietà Count dell'oggetto ListView.ListViewItemCollection.The index parameter is less than 0 or greater than the value of the Count property of the ListView.ListViewItemCollection.

Commenti

Questa versione del Insert metodo consente di inserire un nuovo elemento in una posizione specifica nell'oggetto ListView.ListViewItemCollection .This version of the Insert method allows you to insert a new item at a specific position in the ListView.ListViewItemCollection. Il testo specificato nel text parametro viene usato per creare un nuovo oggetto ListViewItem che viene quindi inserito nell'oggetto nella ListView.ListViewItemCollection posizione specificata.The text specified in the text parameter is used to create a new ListViewItem that is then inserted into the ListView.ListViewItemCollection at the specified location.

Nota

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'inserimento 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 inserted.

È anche possibile usare questa versione del Insert metodo per 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 use this version of the Insert method to 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 l'altra versione del Insert metodo che accetta 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 other version of the Insert method that accepts a string as a parameter.

Per aggiungere un elemento senza specificare una posizione specifica nella raccolta, utilizzare il Add metodo.To add an item without specifying a specific position in the collection, use the Add method. Se si desidera aggiungere una matrice di elementi alla raccolta, utilizzare il AddRange metodo.If you want to add an array of items to the collection, use the AddRange method.

Vedi anche

Si applica a