ListView.ListViewItemCollection.Add Metodo

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

Restituisce

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

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

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

Restituisce

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

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

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

Restituisce

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

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

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

Restituisce

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.

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

Restituisce

ListViewItem aggiunto all'insieme.

Eccezioni

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.

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

Restituisce

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.