Поделиться через


ListView.ListViewItemCollection.Insert Метод

Определение

Вставляет элемент в коллекцию по указанному индексу.

Перегрузки

Insert(Int32, String, String, String)

Создает новый элемент с заданным ключом, текстом и изображением и добавляет его в коллекцию по указанному индексу.

Insert(Int32, String, String, Int32)

Создает новый элемент с заданным ключом, текстом и изображением и вставляет его в коллекцию по указанному индексу.

Insert(Int32, String, String)

Создает новый элемент с заданным текстом и изображением и вставляет его в коллекцию по указанному индексу.

Insert(Int32, ListViewItem)

Вставляет существующий ListViewItem в коллекцию по указанному индексу.

Insert(Int32, String)

Создает новый элемент и вставляет его в коллекцию по указанному индексу.

Insert(Int32, String, Int32)

Создает новый элемент с заданным индексом изображения и вставляет его в коллекцию по указанному индексу.

Insert(Int32, String, String, String)

Создает новый элемент с заданным ключом, текстом и изображением и добавляет его в коллекцию по указанному индексу.

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

Параметры

index
Int32

Отсчитываемое от нуля расположение в индексе для вставки элемента.

key
String

Свойство Name элемента.

text
String

Текст данного элемента.

imageKey
String

Ключ изображения для данного элемента.

Возвращаемое значение

Атрибут ListViewItem, добавленный в коллекцию.

Исключения

Значение параметра index меньше 0 или больше значения свойства Count объекта ListView.ListViewItemCollection.

Комментарии

Метод Insert задает Name для свойства элемента указанный ключ, чтобы элемент можно было получить по индексу или ключу.

Применяется к

Insert(Int32, String, String, Int32)

Создает новый элемент с заданным ключом, текстом и изображением и вставляет его в коллекцию по указанному индексу.

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

Параметры

index
Int32

Отсчитываемое от нуля расположение в индексе для вставки элемента.

key
String

Свойство Name элемента.

text
String

Текст данного элемента.

imageIndex
Int32

Индекс изображения для данного элемента.

Возвращаемое значение

Атрибут ListViewItem, добавленный в коллекцию.

Исключения

Значение параметра index меньше 0 или больше значения свойства Count объекта ListView.ListViewItemCollection.

Комментарии

Метод Insert задает Name для свойства элемента указанный ключ, чтобы элемент можно было получить по индексу или ключу.

Применяется к

Insert(Int32, String, String)

Создает новый элемент с заданным текстом и изображением и вставляет его в коллекцию по указанному индексу.

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

Параметры

index
Int32

Отсчитываемое от нуля расположение в индексе для вставки элемента.

text
String

Текст объекта ListViewItem.

imageKey
String

Ключ изображения для данного элемента.

Возвращаемое значение

Атрибут ListViewItem, добавленный в коллекцию.

Исключения

Значение параметра index меньше 0 или больше значения свойства Count объекта ListView.ListViewItemCollection.

Применяется к

Insert(Int32, ListViewItem)

Вставляет существующий ListViewItem в коллекцию по указанному индексу.

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

Параметры

index
Int32

Отсчитываемое от нуля расположение в индексе для вставки элемента.

item
ListViewItem

Объект ListViewItem, представляющий вставляемый элемент.

Возвращаемое значение

Объект ListViewItem, вставленный в коллекцию.

Исключения

Значение параметра index меньше 0 или больше значения свойства Count объекта ListView.ListViewItemCollection.

Комментарии

Эта версия Insert метода позволяет вставлять существующий ListViewItem объект в определенную позицию ListView.ListViewItemCollectionв .

Примечание

Если свойству ListView.Sorting присвоено значение, отличное от SortOrder.None или если ListViewItemSorter свойство задано, список сортируется после вставки элемента.

Чтобы добавить элемент без указания конкретной позиции в коллекции для добавления элемента, используйте Add метод . Если вы хотите добавить массив элементов в коллекцию, используйте AddRange метод . Этот метод можно использовать, если требуется вставить новый элемент в существующую коллекцию элементов.

См. также раздел

Применяется к

Insert(Int32, String)

Создает новый элемент и вставляет его в коллекцию по указанному индексу.

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

Параметры

index
Int32

Отсчитываемое от нуля расположение в индексе для вставки элемента.

text
String

Текст, отображаемый для элемента.

Возвращаемое значение

Объект ListViewItem, вставленный в коллекцию.

Исключения

Значение параметра index меньше 0 или больше значения свойства Count объекта ListView.ListViewItemCollection.

Комментарии

Эта версия Insert метода позволяет вставить новый элемент в определенную позицию ListView.ListViewItemCollectionв . Текст, указанный в параметре text , используется для создания нового ListViewItem объекта , который затем вставляется в ListView.ListViewItemCollection в указанном расположении.

Примечание

Если свойству ListView.Sorting присвоено значение, отличное от SortOrder.None или если ListViewItemSorter свойство задано, список сортируется после вставки элемента.

Чтобы добавить элемент без указания конкретной позиции в коллекции, используйте Add метод . Если вы хотите добавить массив элементов в коллекцию, используйте AddRange метод . Этот метод можно использовать, если требуется вставить новый элемент в существующую коллекцию элементов.

См. также раздел

Применяется к

Insert(Int32, String, Int32)

Создает новый элемент с заданным индексом изображения и вставляет его в коллекцию по указанному индексу.

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

Параметры

index
Int32

Отсчитываемое от нуля расположение в индексе для вставки элемента.

text
String

Текст, отображаемый для элемента.

imageIndex
Int32

Индекс изображения для данного элемента.

Возвращаемое значение

Объект ListViewItem, вставленный в коллекцию.

Исключения

Значение параметра index меньше 0 или больше значения свойства Count объекта ListView.ListViewItemCollection.

Комментарии

Эта версия Insert метода позволяет вставить новый элемент в определенную позицию ListView.ListViewItemCollectionв . Текст, указанный в параметре text , используется для создания нового ListViewItem объекта , который затем вставляется в ListView.ListViewItemCollection в указанном расположении.

Примечание

Если свойству ListView.Sorting присвоено значение, отличное от SortOrder.None или если ListViewItemSorter свойство задано, список сортируется после вставки элемента.

Эту версию Insert метода также можно использовать для указания изображения для элемента путем передачи индекса, присвоенного ImageList свойствам ListView.LargeImageList и ListView.SmallImageList , в imageIndex параметр . (Как правило, ListView.LargeImageList свойства и ListView.SmallImageList используют одинаковые позиции индекса для отображения связанных изображений.) Если вы не хотите указывать индекс изображения для элемента, используйте другую версию Insert метода , которая принимает строку в качестве параметра.

Чтобы добавить элемент без указания конкретной позиции в коллекции, используйте Add метод . Если вы хотите добавить массив элементов в коллекцию, используйте AddRange метод .

См. также раздел

Применяется к