Condividi tramite


ListView.ListViewItemCollection.Insert Metodo

Definizione

Inserisce un elemento nella raccolta in corrispondenza dell'indice specificato.

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.

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.

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.

Insert(Int32, ListViewItem)

Inserisce nell'insieme un oggetto ListViewItem esistente in corrispondenza dell'indice specificato.

Insert(Int32, String)

Crea un nuovo elemento e lo inserisce nell'insieme in corrispondenza dell'indice specificato.

Insert(Int32, String, Int32)

Crea un nuovo elemento con l'indice di immagine specificato e lo inserisce nell'insieme in corrispondenza dell'indice specificato.

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.

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);
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.

key
String

Proprietà Name dell'elemento.

text
String

Testo dell'elemento.

imageKey
String

Chiave dell'immagine da visualizzare per l'elemento.

Restituisce

ListViewItem aggiunto all'insieme.

Eccezioni

Il parametro index è minore di 0 o maggiore del valore della proprietà Count dell'oggetto ListView.ListViewItemCollection.

Commenti

Il Insert metodo imposta la Name proprietà dell'elemento sulla chiave specificata, in modo che l'elemento possa essere recuperato dall'indice o dalla chiave.

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.

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);
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 viene inserito l'elemento.

key
String

Proprietà Name dell'elemento.

text
String

Testo dell'elemento.

imageIndex
Int32

Indice dell'immagine associata all'elemento.

Restituisce

ListViewItem aggiunto all'insieme.

Eccezioni

Il parametro index è minore di 0 o maggiore del valore della proprietà Count dell'oggetto ListView.ListViewItemCollection.

Commenti

Il Insert metodo imposta la Name proprietà dell'elemento sulla chiave specificata, in modo che l'elemento possa essere recuperato dall'indice o dalla chiave.

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.

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);
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.

text
String

Testo di ListViewItem.

imageKey
String

Chiave dell'immagine da visualizzare per l'elemento.

Restituisce

ListViewItem aggiunto all'insieme.

Eccezioni

Il parametro index è minore di 0 o maggiore del valore della proprietà Count dell'oggetto ListView.ListViewItemCollection.

Si applica a

Insert(Int32, ListViewItem)

Inserisce nell'insieme un oggetto ListViewItem esistente in corrispondenza dell'indice specificato.

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.

item
ListViewItem

Oggetto ListViewItem che rappresenta l'elemento da inserire.

Restituisce

Oggetto ListViewItem inserito nell'insieme.

Eccezioni

Il parametro index è minore di 0 o maggiore del valore della proprietà Count dell'oggetto ListView.ListViewItemCollection.

Commenti

Questa versione del Insert metodo consente di inserire un oggetto esistente ListViewItem in una posizione specifica in ListView.ListViewItemCollection.

Nota

Se la ListView.Sorting proprietà è impostata su un valore diverso SortOrder.None da o se la ListViewItemSorter proprietà è impostata, l'elenco viene ordinato dopo l'inserimento dell'elemento.

Per aggiungere un elemento senza specificare una posizione specifica nella raccolta per aggiungere l'elemento, utilizzare il Add metodo . Se si desidera aggiungere una matrice di elementi alla raccolta, utilizzare il AddRange metodo . È possibile utilizzare questo metodo se si desidera inserire un nuovo elemento in una raccolta esistente di elementi.

Vedi anche

Si applica a

Insert(Int32, String)

Crea un nuovo elemento e lo inserisce nell'insieme in corrispondenza dell'indice specificato.

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text);
public System.Windows.Forms.ListViewItem Insert (int index, 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.

text
String

Testo da visualizzare per l'elemento.

Restituisce

Oggetto ListViewItem inserito nell'insieme.

Eccezioni

Il parametro index è minore di 0 o maggiore del valore della proprietà Count dell'oggetto ListView.ListViewItemCollection.

Commenti

Questa versione del Insert metodo consente di inserire un nuovo elemento in una posizione specifica in ListView.ListViewItemCollection. Il testo specificato nel text parametro viene usato per creare un nuovo ListViewItem oggetto che viene quindi inserito nella ListView.ListViewItemCollection posizione specificata.

Nota

Se la ListView.Sorting proprietà è impostata su un valore diverso SortOrder.None da o se la ListViewItemSorter proprietà è impostata, l'elenco viene ordinato dopo l'inserimento dell'elemento.

Per aggiungere un elemento senza specificare una posizione specifica nella raccolta, utilizzare il Add metodo . Se si desidera aggiungere una matrice di elementi alla raccolta, utilizzare il AddRange metodo . È possibile utilizzare questo metodo se si desidera inserire un nuovo elemento in una raccolta esistente di elementi.

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.

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);
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.

text
String

Testo da visualizzare per l'elemento.

imageIndex
Int32

Indice dell'immagine associata all'elemento.

Restituisce

Oggetto ListViewItem inserito nell'insieme.

Eccezioni

Il parametro index è minore di 0 o maggiore del valore della proprietà Count dell'oggetto ListView.ListViewItemCollection.

Commenti

Questa versione del Insert metodo consente di inserire un nuovo elemento in una posizione specifica in ListView.ListViewItemCollection. Il testo specificato nel text parametro viene usato per creare un nuovo ListViewItem oggetto che viene quindi inserito nella ListView.ListViewItemCollection posizione specificata.

Nota

Se la ListView.Sorting proprietà è impostata su un valore diverso SortOrder.None da o se la ListViewItemSorter proprietà è impostata, l'elenco viene ordinato dopo l'inserimento dell'elemento.

È 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 proprietà e ListView.SmallImageList al imageIndex parametro . In genere, le ListView.LargeImageList proprietà e ListView.SmallImageList usano le stesse posizioni di indice per visualizzare le immagini correlate. Se non si vuole specificare un indice immagine per l'elemento, usare l'altra versione del Insert metodo che accetta una stringa come parametro.

Per aggiungere un elemento senza specificare una posizione specifica nella raccolta, utilizzare il Add metodo . Se si desidera aggiungere una matrice di elementi alla raccolta, utilizzare il AddRange metodo .

Vedi anche

Si applica a