ListView.ListViewItemCollection.Add 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

將項目加入至項目的集合中。

多載

Add(String)	建立具有指定之文字的項目，並將它加入集合中。
Add(ListViewItem)	將現有的 ListViewItem 加入至集合。
Add(String, Int32)	使用指定的文字和影像建立項目，並將它加入至集合中。
Add(String, String)	使用指定的文字和影像建立項目，並將它加入至集合中。
Add(String, String, Int32)	使用指定的索引鍵、文字和影像建立項目，並將項目加入至集合中。
Add(String, String, String)	使用指定的索引鍵、文字和影像建立項目，並將它加入至集合中。

Add(String)

建立具有指定之文字的項目，並將它加入集合中。

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text);

public virtual System.Windows.Forms.ListViewItem Add (string text);

abstract member Add : string -> System.Windows.Forms.ListViewItem
override this.Add : string -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (text As String) As ListViewItem

參數

text

String

要顯示的項目文字。

傳回

ListViewItem

已加入至集合中的 ListViewItem。

備註

您可以使用這個版本的 Add 方法來建立新的 ListViewItem ，以新增至 ListView 控制項。 新增至 控制項之新 ListViewItem 文字是以 參數為基礎 text 。 如果您想要指定專案的映射，請使用接受影像索引做為參數的方法版本 Add 。 如果您有 ListViewItem 想要加入至集合的現有方法，請使用接受 ListViewItem 做為其參數的方法 Add 版本。

ListView.Sorting如果 屬性設定為 或 SortOrder.None ListViewItemSorter 以外的值，則會在新增專案之後排序清單。 否則，專案會插入清單結尾。 如果未排序清單，您可以使用 Insert 方法，將專案插入至 ListView 特定位置。 若要在單一作業中將一組專案新增至 控制項，請使用 AddRange 方法。 如果您想要使用 Add 方法將大量專案新增至 控制項，請使用 BeginUpdate 和 EndUpdate 方法，以防止 ListView 重繪直到新增所有專案為止。 將專案新增至 ListView 時，先排序專案再加入新專案會更有效率。

另請參閱

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

Add(ListViewItem)

將現有的 ListViewItem 加入至集合。

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::Windows::Forms::ListViewItem ^ value);

public virtual System.Windows.Forms.ListViewItem Add (System.Windows.Forms.ListViewItem value);

abstract member Add : System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem
override this.Add : System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (value As ListViewItem) As ListViewItem

參數

value

ListViewItem

要加入至集合的 ListViewItem。

傳回

ListViewItem

已加入至集合中的 ListViewItem。

備註

您可以使用這個版本的 Add 方法，將現有的 ListViewItem 新增至集合。 這個版本的 Add 方法通常用來重複使用來自其他 ListView 控制項的專案，或是在 ListViewItem 將專案新增至集合之前手動建立。 如果您想要建立新的 ListViewItem ，而不是使用現有的專案，請使用方法的其他版本 Add 。

ListView.Sorting如果 屬性設定為 或 SortOrder.None ListViewItemSorter 以外的值，則會在新增專案之後排序清單。 否則，專案會插入清單結尾。 如果未排序清單，您可以使用 Insert 方法，將專案插入至 ListView 特定位置。 若要在單一作業中將一組專案新增至 控制項，請使用 AddRange 方法。 如果您想要使用 Add 方法將大量專案新增至 控制項，請使用 BeginUpdate 和 EndUpdate 方法，以防止 ListView 重繪直到新增所有專案為止。 將專案新增至 ListView 時，先排序專案再加入新專案會更有效率。

這個版本的 Add 方法也可用來將 指派 ListViewItem 給 ListViewGroup 。

另請參閱

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

Add(String, Int32)

使用指定的文字和影像建立項目，並將它加入至集合中。

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text, int imageIndex);

public virtual System.Windows.Forms.ListViewItem Add (string text, int imageIndex);

abstract member Add : string * int -> System.Windows.Forms.ListViewItem
override this.Add : string * int -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (text As String, imageIndex As Integer) As ListViewItem

參數

text

String

項目的文字。

imageIndex

Int32

為項目顯示的影像索引。

傳回

ListViewItem

已加入至集合中的 ListViewItem。

備註

您可以使用這個版本的 Add 方法來建立新的 ListViewItem ，以新增至 ListView 控制項。 新增至 控制項之新 ListViewItem 文字是以 參數為基礎 text 。 您也可以將指派給 和 ListView.SmallImageList 屬性的 ImageList 索引傳遞至 ListView.LargeImageList imageIndex 參數，以指定專案的影像。 (一般而言， ListView.LargeImageList 和 ListView.SmallImageList 屬性使用相同的索引位置來顯示相關的影像。) 如果您不想指定專案的影像索引，請使用只接受字串做為參數的方法版本 Add 。 如果您有 ListViewItem 想要加入至集合的現有方法，請使用接受 ListViewItem 做為其參數的方法 Add 版本。

ListView.Sorting如果 屬性設定為 或 SortOrder.None ListViewItemSorter 以外的值，則會在新增專案之後排序清單。 否則，專案會插入清單結尾。 如果未排序清單，您可以使用 Insert 方法，將專案插入至 ListView 特定位置。 若要在單一作業中將一組專案新增至 控制項，請使用 AddRange 方法。 如果您想要使用 Add 方法將大量專案新增至 控制項，請使用 BeginUpdate 和 EndUpdate 方法，以防止 ListView 重繪直到新增所有專案為止。 將專案新增至 ListView 時，先排序專案再加入新專案會更有效率。

另請參閱

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

Add(String, String)

使用指定的文字和影像建立項目，並將它加入至集合中。

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text, System::String ^ imageKey);

public virtual System.Windows.Forms.ListViewItem Add (string text, string imageKey);

abstract member Add : string * string -> System.Windows.Forms.ListViewItem
override this.Add : string * string -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (text As String, imageKey As String) As ListViewItem

參數

text

String

項目的文字。

imageKey

String

為項目顯示的影像之索引鍵。

傳回

ListViewItem

要加入至集合中的 ListViewItem。

備註

ListView如果 已排序，則會以正確排序的順序加入專案，否則會新增至集合結尾。

Add(String, String, Int32)

使用指定的索引鍵、文字和影像建立項目，並將項目加入至集合中。

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ key, System::String ^ text, int imageIndex);

public virtual System.Windows.Forms.ListViewItem Add (string key, string text, int imageIndex);

abstract member Add : string * string * int -> System.Windows.Forms.ListViewItem
override this.Add : string * string * int -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (key As String, text As String, imageIndex As Integer) As ListViewItem

參數

key

String

項目的名稱。

text

String

項目的文字。

imageIndex

Int32

為項目顯示的影像索引。

傳回

ListViewItem

要加入至集合中的 ListViewItem。

例外狀況

InvalidOperationException

包含的 ListView 處於虛擬模式中。

備註

ListView如果 已排序，則會以正確排序的順序加入專案，否則會新增至集合結尾。 屬性 Name 會對應至 中的 索引 ListView.ListViewItemCollection 鍵 ListViewItem 。

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

Add(String, String, String)

使用指定的索引鍵、文字和影像建立項目，並將它加入至集合中。

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ key, System::String ^ text, System::String ^ imageKey);

public virtual System.Windows.Forms.ListViewItem Add (string key, string text, string imageKey);

abstract member Add : string * string * string -> System.Windows.Forms.ListViewItem
override this.Add : string * string * string -> System.Windows.Forms.ListViewItem

Public Overridable Function Add (key As String, text As String, imageKey As String) As ListViewItem

參數

key

String

項目的名稱。

text

String

項目的文字。

imageKey

String

為項目顯示的影像之索引鍵。

傳回

ListViewItem

要加入至集合中的 ListViewItem。

備註

屬性 Name 會對應至 中的 索引 ListView.ListViewItemCollection 鍵 ListViewItem 。

ListView如果 已排序，則會以正確排序的順序加入專案，否則會新增至集合結尾。 方法 Add 會將 Name 專案的 屬性設定為指定的索引鍵，讓專案可由索引或索引鍵擷取。