ListViewGroupCollection.Add Method

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Adds a ListViewGroup to the collection.

Overloads

Add(ListViewGroup)	Adds the specified ListViewGroup to the collection.
Add(String, String)	Adds a new ListViewGroup to the collection using the specified values to initialize the Name and Header properties.

Add(ListViewGroup)

Adds the specified ListViewGroup to the collection.

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

Parameters

group

ListViewGroup

The ListViewGroup to add to the collection.

Returns

Int32

The index of the group within the collection, or -1 if the group is already present in the collection.

Exceptions

ArgumentException

group contains at least one ListViewItem that belongs to a ListView control other than the one that owns this ListViewGroupCollection.

InvalidOperationException

The ListView that this collection is assigned to is in virtual mode.

Remarks

Use this method to add an existing ListViewGroup to the collection. You cannot add a ListViewGroup to the collection more than once. When you call the Add method using a ListViewGroup that is already in the collection, the addition fails and -1 is returned.

To add multiple groups to the collection, use the AddRange method.

See also

• ListViewGroup

Add(String, String)

Adds a new ListViewGroup to the collection using the specified values to initialize the Name and Header properties.

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

Parameters

key

String

The initial value of the Name property for the new group.

headerText

String

The initial value of the Header property for the new group.

Returns

ListViewGroup

The new ListViewGroup.

Exceptions

InvalidOperationException

The ListView that this collection is assigned to is in virtual mode.