ListView.ListViewItemCollection.Add Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Dodaje element do kolekcji elementów.

Przeciążenia

Add(String)	Tworzy element z określonym tekstem i dodaje go do kolekcji.
Add(ListViewItem)	Dodaje istniejący ListViewItem element do kolekcji.
Add(String, Int32)	Tworzy element z określonym tekstem i obrazem i dodaje go do kolekcji.
Add(String, String)	Tworzy element z określonym tekstem i obrazem i dodaje go do kolekcji.
Add(String, String, Int32)	Tworzy element z określonym kluczem, tekstem i obrazem oraz dodaje element do kolekcji.
Add(String, String, String)	Tworzy element z określonym kluczem, tekstem i obrazem oraz dodaje go do kolekcji.

Add(String)

Tworzy element z określonym tekstem i dodaje go do kolekcji.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::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

Parametry

text

String

Tekst do wyświetlenia dla elementu.

Zwraca

ListViewItem

Element ListViewItem , który został dodany do kolekcji.

Uwagi

Możesz użyć tej wersji Add metody, aby utworzyć nową ListViewItem , aby dodać do kontrolki ListView . Tekst nowego ListViewItem dodanego do kontrolki jest oparty na parametrze text . Jeśli chcesz określić obraz elementu, użyj wersji Add metody, która akceptuje indeks obrazu jako parametr. Jeśli masz istniejący ListViewItem element, który chcesz dodać do kolekcji, użyj wersji Add metody, która akceptuje ListViewItem parametr jako parametr.

ListView.Sorting Jeśli właściwość jest ustawiona na wartość inną niż SortOrder.None lub jeśli ListViewItemSorter właściwość jest ustawiona, lista jest sortowana po dodaniu elementu. W przeciwnym razie element zostanie wstawiony na końcu listy. Jeśli lista nie jest posortowana, możesz użyć Insert metody , aby wstawić element do ListView określonego położenia. Aby dodać zestaw elementów do kontrolki w ramach jednej operacji, użyj AddRange metody . Jeśli chcesz użyć Add metody , aby dodać dużą liczbę elementów do kontrolki, użyj BeginUpdate metod i EndUpdate , aby zapobiec ListView ponownemu malowaniu do momentu dodania wszystkich elementów. Podczas dodawania elementów do elementu ListViewjest wydajniejszy, aby najpierw sortować elementy, a następnie dodawać nowe elementy.

Zobacz też

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

Add(ListViewItem)

Dodaje istniejący ListViewItem element do kolekcji.

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

Parametry

value

ListViewItem

Element ListViewItem do dodania do kolekcji.

Zwraca

ListViewItem

Element ListViewItem , który został dodany do kolekcji.

Uwagi

Możesz użyć tej wersji Add metody, aby dodać istniejącą ListViewItem do kolekcji. Ta wersja Add metody jest zwykle używana do ponownego używania elementów z innych ListView kontrolek lub jeśli ListViewItem została utworzona ręcznie przed dodaniem jej do kolekcji. Jeśli chcesz utworzyć nowy ListViewItem element zamiast używać istniejącego elementu, użyj innych wersji Add metody .

ListView.Sorting Jeśli właściwość jest ustawiona na wartość inną niż SortOrder.None lub jeśli ListViewItemSorter właściwość jest ustawiona, lista jest sortowana po dodaniu elementu. W przeciwnym razie element zostanie wstawiony na końcu listy. Jeśli lista nie jest posortowana, możesz użyć Insert metody , aby wstawić element do ListView określonego położenia. Aby dodać zestaw elementów do kontrolki w ramach jednej operacji, użyj AddRange metody . Jeśli chcesz użyć Add metody , aby dodać dużą liczbę elementów do kontrolki, użyj BeginUpdate metod i EndUpdate , aby zapobiec ListView ponownemu malowaniu do momentu dodania wszystkich elementów. Podczas dodawania elementów do elementu ListViewjest wydajniejszy, aby najpierw sortować elementy, a następnie dodawać nowe elementy.

Ta wersja Add metody jest również używana do przypisywania ListViewItem obiektu do obiektu ListViewGroup.

Zobacz też

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

Add(String, Int32)

Tworzy element z określonym tekstem i obrazem i dodaje go do kolekcji.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::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

Parametry

text

String

Tekst elementu.

imageIndex

Int32

Indeks obrazu do wyświetlenia dla elementu.

Zwraca

ListViewItem

Element ListViewItem , który został dodany do kolekcji.

Uwagi

Możesz użyć tej wersji Add metody, aby utworzyć nową ListViewItem , aby dodać do kontrolki ListView . Tekst nowego ListViewItem dodanego do kontrolki jest oparty na parametrze text . Można również określić obraz elementu, przekazując indeks ImageList przypisany do ListView.LargeImageList właściwości i ListView.SmallImageList do parametru imageIndex . (Zazwyczaj ListView.LargeImageList właściwości i ListView.SmallImageList używają tych samych pozycji indeksu do wyświetlania powiązanych obrazów). Jeśli nie chcesz określać indeksu obrazu dla elementu, użyj wersji Add metody, która akceptuje tylko ciąg jako parametr. Jeśli masz istniejący ListViewItem element, który chcesz dodać do kolekcji, użyj wersji Add metody, która akceptuje ListViewItem parametr jako parametr.

ListView.Sorting Jeśli właściwość jest ustawiona na wartość inną niż SortOrder.None lub jeśli ListViewItemSorter właściwość jest ustawiona, lista jest sortowana po dodaniu elementu. W przeciwnym razie element zostanie wstawiony na końcu listy. Jeśli lista nie jest posortowana, możesz użyć Insert metody , aby wstawić element do ListView określonego położenia. Aby dodać zestaw elementów do kontrolki w ramach jednej operacji, użyj AddRange metody . Jeśli chcesz użyć Add metody , aby dodać dużą liczbę elementów do kontrolki, użyj BeginUpdate metod i EndUpdate , aby zapobiec ListView ponownemu malowaniu do momentu dodania wszystkich elementów. Podczas dodawania elementów do elementu ListViewjest wydajniejszy, aby najpierw sortować elementy, a następnie dodawać nowe elementy.

Zobacz też

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

Add(String, String)

Tworzy element z określonym tekstem i obrazem i dodaje go do kolekcji.

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

Parametry

text

String

Tekst elementu.

imageKey

String

Klucz obrazu do wyświetlenia dla elementu.

Zwraca

ListViewItem

Dodany ListViewItem do kolekcji.

Uwagi

ListView Jeśli element jest posortowany, zostanie dodany w prawidłowej kolejności sortowania. W przeciwnym razie zostanie dodany na końcu kolekcji.

Add(String, String, Int32)

Tworzy element z określonym kluczem, tekstem i obrazem oraz dodaje element do kolekcji.

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

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

Parametry

key

String

Nazwa elementu .

text

String

Tekst elementu.

imageIndex

Int32

Indeks obrazu do wyświetlenia dla elementu.

Zwraca

ListViewItem

Dodany ListViewItem do kolekcji.

Wyjątki

InvalidOperationException

Element zawierający ListView jest w trybie wirtualnym.

Uwagi

ListView Jeśli element jest posortowany, zostanie dodany w prawidłowej kolejności sortowania. W przeciwnym razie zostanie dodany na końcu kolekcji. Właściwość Name odpowiada kluczowi elementu ListViewItem w obiekcie ListView.ListViewItemCollection.

Metoda Add ustawia Name właściwość na określony klucz, więc element można pobrać za pomocą jego indeksu lub klucza.

Add(String, String, String)

Tworzy element z określonym kluczem, tekstem i obrazem oraz dodaje go do kolekcji.

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

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

Parametry

key

String

Nazwa elementu .

text

String

Tekst elementu.

imageKey

String

Klucz obrazu do wyświetlenia dla elementu.

Zwraca

ListViewItem

Dodany ListViewItem do kolekcji.

Uwagi

Właściwość Name odpowiada kluczowi elementu ListViewItem w obiekcie ListView.ListViewItemCollection.

ListView Jeśli element jest posortowany, zostanie dodany w prawidłowej kolejności sortowania. W przeciwnym razie zostanie dodany na końcu kolekcji. Metoda Add ustawia Name właściwość elementu na określony klucz, aby element mógł zostać pobrany przez jego indeks lub klucz.