ListView.ListViewItemCollection.Add Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Dodaje element do kolekcji elementów.

Przeciążenia

Nazwa	Opis
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)

Źródło:

ListView.ListViewItemCollection.cs

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ć element do kontrolki ListView . Tekst nowego ListViewItem dodanego do kontrolki jest oparty na parametrze text . Jeśli chcesz określić obraz dla elementu, użyj wersji Add metody, która akceptuje indeks obrazu jako parametr. Jeśli masz istniejącą, ListViewItem którą 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 elementu w określonej pozycji. 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 przemalowaniu elementu do momentu dodania wszystkich elementów. Podczas dodawania elementów do elementu ListViewbardziej wydajne jest najpierw sortowanie elementów, a następnie dodawanie nowych elementów.

Zobacz też

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

Add(ListViewItem)

Źródło:

ListView.ListViewItemCollection.cs

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ć nową ListViewItem 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 elementu w określonej pozycji. 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 przemalowaniu elementu do momentu dodania wszystkich elementów. Podczas dodawania elementów do elementu ListViewbardziej wydajne jest najpierw sortowanie elementów, a następnie dodawanie nowych elementów.

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

Zobacz też

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

Add(String, Int32)

Źródło:

ListView.ListViewItemCollection.cs

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ć nowy ListViewItem element do dodania do kontrolki ListView . Tekst nowego ListViewItem dodanego do kontrolki jest oparty na parametrze text . Można również określić obraz dla elementu, przekazując indeks ImageList przypisanego 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ącą, ListViewItem którą 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 elementu w określonej pozycji. 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 przemalowaniu elementu do momentu dodania wszystkich elementów. Podczas dodawania elementów do elementu ListViewbardziej wydajne jest najpierw sortowanie elementów, a następnie dodawanie nowych elementów.

Zobacz też

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

Add(String, String)

Źródło:

ListView.ListViewItemCollection.cs

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

Element ListViewItem dodany do kolekcji.

Uwagi

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

Add(String, String, Int32)

Źródło:

ListView.ListViewItemCollection.cs

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 towaru.

text

String

Tekst elementu.

imageIndex

Int32

Indeks obrazu do wyświetlenia dla elementu.

Zwraca

ListViewItem

Element ListViewItem dodany do kolekcji.

Wyjątki

InvalidOperationException

Element zawierający ListView jest w trybie wirtualnym.

Uwagi

ListView Jeśli element zostanie posortowany, element zostanie dodany w prawidłowej kolejności sortowania. W przeciwnym razie zostanie dodany na końcu kolekcji. Właściwość Name odpowiada kluczowi obiektu 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)

Źródło:

ListView.ListViewItemCollection.cs

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 towaru.

text

String

Tekst elementu.

imageKey

String

Klucz obrazu do wyświetlenia dla elementu.

Zwraca

ListViewItem

Element ListViewItem dodany do kolekcji.

Uwagi

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

ListView Jeśli element zostanie posortowany, element 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.