ListView.ListViewItemCollection.Insert 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
将项插入集合中的指定索引处。
重载
| 名称 | 说明 |
|---|---|
| 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此版本，可以在其中的特定位置ListView.ListViewItemCollection插入现有ListViewItem项。
注释
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方法通过将分配给ListView.LargeImageList项的ImageList索引和ListView.SmallImageList属性传递给imageIndex参数来指定项的映像。 （通常， ListView.LargeImageList 属性 ListView.SmallImageList 使用相同的索引位置来显示相关图像。如果不想指定项的图像索引，请使用接受字符串作为参数的方法的其他版本 Insert 。
若要在不指定集合中的特定位置的情况下添加项，请使用 Add 该方法。 如果要将项数组添加到集合，请使用 AddRange 该方法。
