共用方式為


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 參數小於零,或大於 CountListView.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 參數小於零,或大於 CountListView.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 參數小於零,或大於 CountListView.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 參數小於零,或大於 CountListView.ListViewItemCollection 屬性值。

備註

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

注意

ListView.Sorting如果 屬性設定為 或 SortOrder.NoneListViewItemSorter 以外的值,則會在插入專案之後排序清單。

若要新增專案,而不指定集合中的特定位置以新增專案,請使用 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 參數小於零,或大於 CountListView.ListViewItemCollection 屬性值。

備註

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

注意

ListView.Sorting如果 屬性設定為 或 SortOrder.NoneListViewItemSorter 以外的值,則會在插入專案之後排序清單。

若要新增專案而不指定集合中的特定位置,請使用 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 參數小於零,或大於 CountListView.ListViewItemCollection 屬性值。

備註

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

注意

ListView.Sorting如果 屬性設定為 或 SortOrder.NoneListViewItemSorter 以外的值,則會在插入專案之後排序清單。

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

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

另請參閱

適用於