ListView.ListViewItemCollection.Insert Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Inserisce un elemento nella raccolta in corrispondenza dell'indice specificato.
Overload
| Nome | Descrizione |
|---|---|
| Insert(Int32, String, String, String) |
Crea un nuovo elemento con la chiave, il testo e l'immagine specificati e lo aggiunge alla raccolta in corrispondenza dell'indice specificato. |
| Insert(Int32, String, String, Int32) |
Crea un nuovo elemento con la chiave, il testo e l'immagine specificati 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 nella raccolta in corrispondenza dell'indice specificato. |
| Insert(Int32, ListViewItem) |
Inserisce un oggetto esistente ListViewItem nell'insieme in corrispondenza dell'indice specificato. |
| Insert(Int32, String) |
Crea un nuovo elemento e lo inserisce nella raccolta in corrispondenza dell'indice specificato. |
| Insert(Int32, String, Int32) |
Crea un nuovo elemento con l'indice immagine specificato e lo inserisce nella raccolta in corrispondenza dell'indice specificato. |
Insert(Int32, String, String, String)
Crea un nuovo elemento con la chiave, il testo e l'immagine specificati e lo aggiunge alla raccolta 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.ListViewItemPublic Overridable Function Insert (index As Integer, key As String, text As String, imageKey As String) As ListViewItemParametri
- index
- Int32
Posizione dell'indice in base zero in cui viene inserito l'elemento.
- text
- String
Testo dell'elemento.
- imageKey
- String
Chiave dell'immagine da visualizzare per l'elemento.
Restituisce
Oggetto ListViewItem aggiunto alla raccolta.
Eccezioni
Il index parametro è minore di 0 o maggiore del valore della Count proprietà 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 dal relativo indice o dalla chiave.
Si applica a
Insert(Int32, String, String, Int32)
Crea un nuovo elemento con la chiave, il testo e l'immagine specificati 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.ListViewItemPublic Overridable Function Insert (index As Integer, key As String, text As String, imageIndex As Integer) As ListViewItemParametri
- index
- Int32
Posizione dell'indice in base zero in cui viene inserito l'elemento.
- text
- String
Testo dell'elemento.
- imageIndex
- Int32
Indice dell'immagine da visualizzare per l'elemento.
Restituisce
Oggetto ListViewItem aggiunto alla raccolta.
Eccezioni
Il index parametro è minore di 0 o maggiore del valore della Count proprietà 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 dal relativo 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 nella raccolta 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.ListViewItemPublic Function Insert (index As Integer, text As String, imageKey As String) As ListViewItemParametri
- index
- Int32
Posizione dell'indice in base zero in cui viene inserito l'elemento.
- text
- String
Testo dell'oggetto ListViewItem.
- imageKey
- String
Chiave dell'immagine da visualizzare per l'elemento.
Restituisce
Oggetto ListViewItem aggiunto alla raccolta.
Eccezioni
Il index parametro è minore di 0 o maggiore del valore della Count proprietà dell'oggetto ListView.ListViewItemCollection.
Si applica a
Insert(Int32, ListViewItem)
Inserisce un oggetto esistente ListViewItem nell'insieme 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.ListViewItemPublic Function Insert (index As Integer, item As ListViewItem) As ListViewItemParametri
- index
- Int32
Posizione dell'indice in base zero in cui viene inserito l'elemento.
- item
- ListViewItem
Oggetto ListViewItem che rappresenta l'elemento da inserire.
Restituisce
Oggetto ListViewItem inserito nell'insieme.
Eccezioni
Il index parametro è minore di 0 o maggiore del valore della Count proprietà dell'oggetto ListView.ListViewItemCollection.
Commenti
Questa versione del Insert metodo consente di inserire un oggetto esistente ListViewItem in una posizione specifica nell'oggetto ListView.ListViewItemCollection.
Annotazioni
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 nella raccolta 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.ListViewItemPublic Function Insert (index As Integer, text As String) As ListViewItemParametri
- index
- Int32
Posizione dell'indice in base zero in cui viene inserito l'elemento.
- text
- String
Testo da visualizzare per l'elemento.
Restituisce
Oggetto ListViewItem inserito nell'insieme.
Eccezioni
Il index parametro è minore di 0 o maggiore del valore della Count proprietà 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 in ListView.ListViewItemCollection nella posizione specificata.
Annotazioni
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 immagine specificato e lo inserisce nella raccolta 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.ListViewItemPublic Function Insert (index As Integer, text As String, imageIndex As Integer) As ListViewItemParametri
- index
- Int32
Posizione dell'indice in base zero in cui viene inserito l'elemento.
- text
- String
Testo da visualizzare per l'elemento.
- imageIndex
- Int32
Indice dell'immagine da visualizzare per l'elemento.
Restituisce
Oggetto ListViewItem inserito nell'insieme.
Eccezioni
Il index parametro è minore di 0 o maggiore del valore della Count proprietà 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 in ListView.ListViewItemCollection nella posizione specificata.
Annotazioni
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 desidera specificare un indice di 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 .
