ListView.ListViewItemCollection.Insert 方法

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

參數

傳回

要加入至集合中的 ListViewItem。

例外狀況

備註

方法 Insert 會將 Name 專案的 屬性設定為指定的索引鍵，讓專案可由索引或索引鍵擷取。

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

參數

傳回

要加入至集合中的 ListViewItem。

例外狀況

備註

方法 Insert 會將 Name 專案的 屬性設定為指定的索引鍵，讓專案可由索引或索引鍵擷取。

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

參數

傳回

要加入至集合中的 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

參數

傳回

已插入集合中的 ListViewItem。

例外狀況

備註

這個版本的 Insert 方法可讓您在 中的 ListView.ListViewItemCollection 特定位置插入現有的 ListViewItem 。

若要新增專案，而不指定集合中的特定位置以新增專案，請使用 Add 方法。 如果您想要將專案陣列新增至集合，請使用 AddRange 方法。 如果您想要將新專案插入現有的專案集合中，可以使用這個方法。

另請參閱

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

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

參數

傳回

已插入集合中的 ListViewItem。

例外狀況

備註

這個版本的 Insert 方法可讓您在 中的 ListView.ListViewItemCollection 特定位置插入新專案。 參數中指定的 text 文字是用來建立新的 ListViewItem ，然後插入至 ListView.ListViewItemCollection 指定位置的 。

若要新增專案而不指定集合中的特定位置，請使用 Add 方法。 如果您想要將專案陣列新增至集合，請使用 AddRange 方法。 如果您想要將新專案插入現有的專案集合中，可以使用這個方法。

另請參閱

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

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

參數

傳回

已插入集合中的 ListViewItem。

例外狀況

備註

這個版本的 Insert 方法可讓您在 中的 ListView.ListViewItemCollection 特定位置插入新專案。 參數中指定的 text 文字是用來建立新的 ListViewItem ，然後插入至 ListView.ListViewItemCollection 指定位置的 。

您也可以使用這個版本的 Insert 方法來指定專案的影像，方法是將指派給 ListView.LargeImageList 和 ListView.SmallImageList 屬性 imageIndex 的 ImageList 索引傳遞給 參數。 (一般而言， ListView.LargeImageList 和 ListView.SmallImageList 屬性使用相同的索引位置來顯示相關的影像。) 如果您不想指定專案的影像索引，請使用接受字串做為參數的其他方法版本 Insert 。

若要新增專案而不指定集合中的特定位置，請使用 Add 方法。 如果您想要將專案陣列新增至集合，請使用 AddRange 方法。

另請參閱

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