ListView.ListViewItemCollection.Insert Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

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

ListViewItem aggiunto all'insieme.

Eccezioni

ArgumentOutOfRangeException

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.

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

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

ListViewItem aggiunto all'insieme.

Eccezioni

ArgumentOutOfRangeException

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.

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

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

ListViewItem aggiunto all'insieme.

Eccezioni

ArgumentOutOfRangeException

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

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

ListViewItem

Oggetto ListViewItem inserito nell'insieme.

Eccezioni

ArgumentOutOfRangeException

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

• Add(String)
• AddRange(ListViewItem[])

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

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

ListViewItem

Oggetto ListViewItem inserito nell'insieme.

Eccezioni

ArgumentOutOfRangeException

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

• Add(String)
• AddRange(ListViewItem[])

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

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

ListViewItem

Oggetto ListViewItem inserito nell'insieme.

Eccezioni

ArgumentOutOfRangeException

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

• Add(String)
• AddRange(ListViewItem[])