Condividi tramite

ListView.ListViewItemCollection.Add Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Aggiunge un elemento all'insieme.

Overload

Add(String)

Crea un elemento con il testo specificato e lo aggiunge all'insieme.
Add(ListViewItem)

Aggiunge un oggetto ListViewItem esistente all'insieme.
Add(String, Int32)

Crea un elemento con il testo e l'immagine specificati e lo aggiunge all'insieme.
Add(String, String)

Crea un elemento con il testo e l'immagine specificati e lo aggiunge all'insieme.
Add(String, String, Int32)

Crea un elemento con la chiave, il testo e l'immagine specificati e aggiunge un elemento all'insieme.
Add(String, String, String)

Crea un elemento con la chiave, il testo e l'immagine specificati e lo aggiunge all'insieme.

Add(String)

Crea un elemento con il testo specificato e lo aggiunge all'insieme.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text);
public virtual System.Windows.Forms.ListViewItem Add (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.

Restituisce

ListViewItem

ListViewItem aggiunto all'insieme.

Commenti

È possibile utilizzare questa versione del Add metodo per creare un nuovo ListViewItem oggetto da aggiungere a un ListView controllo . Il testo del nuovo ListViewItem aggiunto al controllo è basato sul text parametro . Se si vuole specificare un'immagine per l'elemento, usare la versione del Add metodo che accetta un indice immagine come parametro. Se si dispone di un oggetto esistente ListViewItem che si vuole aggiungere alla raccolta, usare la versione del Add metodo che accetta un ListViewItem oggetto come parametro.

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. In caso contrario, l'elemento viene inserito alla fine dell'elenco. Se l'elenco non è ordinato, è possibile utilizzare il Insert metodo per inserire un elemento in ListView una posizione specifica. Per aggiungere un set di elementi al controllo in una singola operazione, utilizzare il AddRange metodo . Se si desidera utilizzare il Add metodo per aggiungere un numero elevato di elementi al controllo, utilizzare i BeginUpdate metodi e EndUpdate per impedire l'aggiornamento di tutti gli elementi fino all'aggiunta ListView di tutti gli elementi. Quando si aggiungono elementi a , ListViewè più efficiente ordinare prima gli elementi e quindi aggiungere nuovi elementi.

Vedi anche

Si applica a

Add(ListViewItem)

Aggiunge un oggetto ListViewItem esistente all'insieme.

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.

Restituisce

ListViewItem

ListViewItem aggiunto all'insieme.

Commenti

È possibile utilizzare questa versione del Add metodo per aggiungere un oggetto esistente ListViewItem alla raccolta. 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. Se si vuole creare un nuovo ListViewItem elemento anziché usare un elemento esistente, usare le altre versioni del Add metodo .

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. In caso contrario, l'elemento viene inserito alla fine dell'elenco. Se l'elenco non è ordinato, è possibile utilizzare il Insert metodo per inserire un elemento in ListView una posizione specifica. Per aggiungere un set di elementi al controllo in una singola operazione, utilizzare il AddRange metodo . Se si desidera utilizzare il Add metodo per aggiungere un numero elevato di elementi al controllo, utilizzare i BeginUpdate metodi e EndUpdate per impedire l'aggiornamento di tutti gli elementi fino all'aggiunta ListView di tutti gli elementi. Quando si aggiungono elementi a , ListViewè più efficiente ordinare prima gli elementi e quindi aggiungere nuovi elementi.

Questa versione del Add metodo viene usata anche per assegnare un ListViewItem oggetto a un oggetto ListViewGroup.

Vedi anche

Si applica a

Add(String, Int32)

Crea un elemento con il testo e l'immagine specificati e lo aggiunge all'insieme.

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

imageIndex
Int32

Indice dell'immagine associata all'elemento.

Restituisce

ListViewItem

ListViewItem aggiunto all'insieme.

Commenti

È possibile utilizzare questa versione del Add metodo per creare un nuovo ListViewItem oggetto da aggiungere al ListView controllo. Il testo del nuovo ListViewItem aggiunto al controllo è basato sul text parametro . È anche possibile 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 la versione del Add metodo che accetta solo una stringa come parametro. Se si dispone di un oggetto esistente ListViewItem che si vuole aggiungere alla raccolta, usare la versione del Add metodo che accetta un ListViewItem oggetto come parametro.

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. In caso contrario, l'elemento viene inserito alla fine dell'elenco. Se l'elenco non è ordinato, è possibile utilizzare il Insert metodo per inserire un elemento in ListView una posizione specifica. Per aggiungere un set di elementi al controllo in una singola operazione, utilizzare il AddRange metodo . Se si desidera utilizzare il Add metodo per aggiungere un numero elevato di elementi al controllo, utilizzare i BeginUpdate metodi e EndUpdate per impedire l'aggiornamento di tutti gli elementi fino all'aggiunta ListView di tutti gli elementi. Quando si aggiungono elementi a , ListViewè più efficiente ordinare prima gli elementi e quindi aggiungere nuovi elementi.

Vedi anche

Si applica a

Add(String, String)

Crea un elemento con il testo e l'immagine specificati e lo aggiunge all'insieme.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text, System::String ^ imageKey);
public virtual System.Windows.Forms.ListViewItem Add (string text, 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.

imageKey
String

Chiave dell'immagine da visualizzare per l'elemento.

Restituisce

ListViewItem

ListViewItem aggiunto all'insieme.

Commenti

Se l'oggetto ListView è ordinato, l'elemento viene aggiunto nell'ordine ordinato correttamente; in caso contrario, viene aggiunto alla fine dell'insieme.

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.

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

text
String

Testo dell'elemento.

imageIndex
Int32

Indice dell'immagine associata all'elemento.

Restituisce

ListViewItem

ListViewItem aggiunto all'insieme.

Eccezioni

InvalidOperationException

L'oggetto ListView contenente è in modalità virtuale.

Commenti

Se l'oggetto ListView è ordinato, l'elemento viene aggiunto nell'ordine ordinato correttamente; in caso contrario, viene aggiunto alla fine dell'insieme. La Name proprietà corrisponde alla chiave per un ListViewItem oggetto in ListView.ListViewItemCollection.

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

Si applica a

Add(String, String, String)

Crea un elemento con la chiave, il testo e l'immagine specificati e lo aggiunge all'insieme.

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

text
String

Testo dell'elemento.

imageKey
String

Chiave dell'immagine da visualizzare per l'elemento.

Restituisce

ListViewItem

ListViewItem aggiunto all'insieme.

Commenti

La Name proprietà corrisponde alla chiave per un ListViewItem oggetto in ListView.ListViewItemCollection.

Se l'oggetto ListView è ordinato, l'elemento viene aggiunto nell'ordine ordinato correttamente; in caso contrario, viene aggiunto alla fine dell'insieme. Il Add 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