Udostępnij za pośrednictwem


ListView.ListViewItemCollection.Insert Metoda

Definicja

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

Dodany ListViewItem do kolekcji.

Wyjątki

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.

Dotyczy

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

Dodany ListViewItem do kolekcji.

Wyjątki

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.

Dotyczy

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

Dodany ListViewItem do kolekcji.

Wyjątki

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

Dotyczy

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

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

Wyjątki

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ż

Dotyczy

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

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

Wyjątki

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ż

Dotyczy

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

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

Wyjątki

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ż

Dotyczy