ListView.ListViewItemCollection.Insert Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Wstawia element do kolekcji w określonym indeksie.

Przeciążenia

Insert(Int32, String, String, String)	Tworzy nowy element z określonym kluczem, tekstem i obrazem i dodaje go do kolekcji w określonym indeksie.
Insert(Int32, String, String, Int32)	Tworzy nowy element z określonym kluczem, tekstem i obrazem i wstawia go w kolekcji w określonym indeksie.
Insert(Int32, String, String)	Tworzy nowy element z określonym tekstem i obrazem i wstawia go w kolekcji w określonym indeksie.
Insert(Int32, ListViewItem)	Wstawia istniejący ListViewItem element do kolekcji w określonym indeksie.
Insert(Int32, String)	Tworzy nowy element i wstawia go do kolekcji w określonym indeksie.
Insert(Int32, String, Int32)	Tworzy nowy element z określonym indeksem obrazu i wstawia go do kolekcji w określonym indeksie.

Insert(Int32, String, String, String)

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

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

abstract member Insert : int * string * string * string -> System.Windows.Forms.ListViewItem
override this.Insert : int * string * string * string -> System.Windows.Forms.ListViewItem

Public Overridable Function Insert (index As Integer, key As String, text As String, imageKey As String) As ListViewItem

Parametry

index

Int32

Lokalizacja indeksu zero, w której wstawiono element.

key

String

Element Name .

text

String

Tekst elementu.

imageKey

String

Klucz obrazu do wyświetlenia dla elementu.

Zwraca

ListViewItem

Dodany ListViewItem do kolekcji.

Wyjątki

ArgumentOutOfRangeException

Parametr index jest mniejszy niż 0 lub większy niż wartość Count właściwości ListView.ListViewItemCollection.

Uwagi

Metoda Insert ustawia Name właściwość elementu na określony klucz, aby element mógł zostać pobrany przez jego indeks lub klucz.

Insert(Int32, String, String, Int32)

Tworzy nowy element z określonym kluczem, tekstem i obrazem i wstawia go w kolekcji w określonym indeksie.

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

abstract member Insert : int * string * string * int -> System.Windows.Forms.ListViewItem
override this.Insert : int * string * string * int -> System.Windows.Forms.ListViewItem

Public Overridable Function Insert (index As Integer, key As String, text As String, imageIndex As Integer) As ListViewItem

Parametry

index

Int32

Lokalizacja indeksu zero, w której wstawiono element.

key

String

Element Name .

text

String

Tekst elementu.

imageIndex

Int32

Indeks obrazu do wyświetlenia dla elementu.

Zwraca

ListViewItem

Dodany ListViewItem do kolekcji.

Wyjątki

ArgumentOutOfRangeException

Parametr index jest mniejszy niż 0 lub większy niż wartość Count właściwości ListView.ListViewItemCollection.

Uwagi

Metoda Insert ustawia Name właściwość elementu na określony klucz, aby element mógł zostać pobrany przez jego indeks lub klucz.

Insert(Int32, String, String)

Tworzy nowy element z określonym tekstem i obrazem i wstawia go w kolekcji w określonym indeksie.

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

member this.Insert : int * string * string -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, text As String, imageKey As String) As ListViewItem

Parametry

index

Int32

Lokalizacja indeksu zero, w której wstawiono element.

text

String

Tekst elementu ListViewItem.

imageKey

String

Klucz obrazu do wyświetlenia dla elementu.

Zwraca

ListViewItem

Dodany ListViewItem do kolekcji.

Wyjątki

ArgumentOutOfRangeException

Parametr index jest mniejszy niż 0 lub większy niż wartość Count właściwości ListView.ListViewItemCollection.

Insert(Int32, ListViewItem)

Wstawia istniejący ListViewItem element do kolekcji w określonym indeksie.

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

Public Function Insert (index As Integer, item As ListViewItem) As ListViewItem

Parametry

index

Int32

Lokalizacja indeksu zero, w której wstawiono element.

item

ListViewItem

Element ListViewItem , który reprezentuje element do wstawienia.

Zwraca

ListViewItem

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

Wyjątki

ArgumentOutOfRangeException

Parametr index jest mniejszy niż 0 lub większy niż wartość Count właściwości ListView.ListViewItemCollection.

Uwagi

Ta wersja Insert metody umożliwia wstawienie istniejącego elementu ListViewItem w określonej pozycji w obiekcie ListView.ListViewItemCollection.

Uwaga

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 wstawieniu elementu.

Aby dodać element bez określania określonej pozycji w kolekcji w celu dodania elementu, użyj Add metody . Jeśli chcesz dodać tablicę elementów do kolekcji, użyj AddRange metody . Możesz użyć tej metody, jeśli chcesz wstawić nowy element do istniejącej kolekcji elementów.

Zobacz też

• Add(String)
• AddRange(ListViewItem[])

Insert(Int32, String)

Tworzy nowy element i wstawia go do kolekcji w określonym indeksie.

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text);

public System.Windows.Forms.ListViewItem Insert (int index, string? text);

member this.Insert : int * string -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, text As String) As ListViewItem

Parametry

index

Int32

Lokalizacja indeksu zero, w której wstawiono element.

text

String

Tekst do wyświetlenia dla elementu.

Zwraca

ListViewItem

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

Wyjątki

ArgumentOutOfRangeException

Parametr index jest mniejszy niż 0 lub większy niż wartość Count właściwości ListView.ListViewItemCollection.

Uwagi

Ta wersja Insert metody umożliwia wstawienie nowego elementu w określonej pozycji w elemencie ListView.ListViewItemCollection. Tekst określony w parametrze text służy do tworzenia nowego ListViewItem , który następnie jest wstawiany do ListView.ListViewItemCollection określonej lokalizacji.

Uwaga

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 wstawieniu elementu.

Aby dodać element bez określania określonej pozycji w kolekcji, użyj Add metody . Jeśli chcesz dodać tablicę elementów do kolekcji, użyj AddRange metody . Możesz użyć tej metody, jeśli chcesz wstawić nowy element do istniejącej kolekcji elementów.

Zobacz też

• Add(String)
• AddRange(ListViewItem[])

Insert(Int32, String, Int32)

Tworzy nowy element z określonym indeksem obrazu i wstawia go do kolekcji w określonym indeksie.

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

member this.Insert : int * string * int -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, text As String, imageIndex As Integer) As ListViewItem

Parametry

index

Int32

Lokalizacja indeksu zero, w której wstawiono element.

text

String

Tekst do wyświetlenia dla elementu.

imageIndex

Int32

Indeks obrazu do wyświetlenia dla elementu.

Zwraca

ListViewItem

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

Wyjątki

ArgumentOutOfRangeException

Parametr index jest mniejszy niż 0 lub większy niż wartość Count właściwości ListView.ListViewItemCollection.

Uwagi

Ta wersja Insert metody umożliwia wstawienie nowego elementu w określonej pozycji w elemencie ListView.ListViewItemCollection. Tekst określony w parametrze text służy do tworzenia nowego ListViewItem , który następnie jest wstawiany do ListView.ListViewItemCollection określonej lokalizacji.

Uwaga

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 wstawieniu elementu.

Możesz również użyć tej wersji Insert metody, aby 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 innej wersji Insert metody, która akceptuje ciąg jako parametr.

Aby dodać element bez określania określonej pozycji w kolekcji, użyj Add metody . Jeśli chcesz dodać tablicę elementów do kolekcji, użyj AddRange metody .

Zobacz też

• Add(String)
• AddRange(ListViewItem[])