ListViewGroupCollection.Add 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

將 ListViewGroup 加入集合。

多載

Add(ListViewGroup)	將指定的 ListViewGroup 加入至集合。
Add(String, String)	使用指定值將新的 ListViewGroup 新增至集合，以初始化 Name 和 Header 屬性。

Add(ListViewGroup)

將指定的 ListViewGroup 加入至集合。

public:
 int Add(System::Windows::Forms::ListViewGroup ^ group);

public int Add (System.Windows.Forms.ListViewGroup group);

member this.Add : System.Windows.Forms.ListViewGroup -> int

Public Function Add (group As ListViewGroup) As Integer

參數

group

ListViewGroup

要加入至集合的 ListViewGroup。

傳回

Int32

群組在集合內的索引；如果群組已在集合中，則為 -1。

例外狀況

ArgumentException

group 包含的 ListViewItem 中，至少有一個屬於不是擁有此 ListView 的 ListViewGroupCollection 控制項。

InvalidOperationException

ListView指派給這個集合的 處於虛擬模式。

備註

使用這個方法可將現有的 ListViewGroup 新增至集合。 您無法多次將 加入 ListViewGroup 至集合。 當您使用 ListViewGroup 已經在集合中的 呼叫 Add 方法時，加法會失敗並傳回 -1。

若要將多個群組新增至集合，請使用 AddRange 方法。

另請參閱

• ListViewGroup

Add(String, String)

使用指定值將新的 ListViewGroup 新增至集合，以初始化 Name 和 Header 屬性。

public:
 System::Windows::Forms::ListViewGroup ^ Add(System::String ^ key, System::String ^ headerText);

public System.Windows.Forms.ListViewGroup Add (string? key, string? headerText);

member this.Add : string * string -> System.Windows.Forms.ListViewGroup

Public Function Add (key As String, headerText As String) As ListViewGroup

參數

key

String

新群組之 Name 屬性的初始值。

headerText

String

新群組之 Header 屬性的初始值。

傳回

ListViewGroup

新的 ListViewGroup。

例外狀況

InvalidOperationException

ListView指派給這個集合的 處於虛擬模式。