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.ListViewItemPublic Overridable Function Insert (index As Integer, key As String, text As String, imageKey As String) As ListViewItemПараметры
- index
- Int32
Отсчитываемое от нуля расположение в индексе для вставки элемента.
- 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.ListViewItemPublic Overridable Function Insert (index As Integer, key As String, text As String, imageIndex As Integer) As ListViewItemПараметры
- index
- Int32
Отсчитываемое от нуля расположение в индексе для вставки элемента.
- 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.ListViewItemPublic 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.ListViewItemPublic 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.ListViewItemPublic 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.ListViewItemPublic 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 метод .
