ListView::Clear Method ()
Removes all items and columns from the control.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
You can use this method to remove all items and columns from the ListView control without having to call the individual Clear methods from the ListView::ColumnHeaderCollection and ListView::ListViewItemCollection classes.
Note |
|---|
The Clear method does not clear Groups specified for the ListView control. To clear Groups call ListViewGroupCollection::Clear. |
The following code example demonstrates the use of Clear and ListViewItem::Selected members. To run this example, paste the following code into a form that contains a ListView named ListView1 and a button, located toward the bottom of the form, named Button1. Call the InitializeListView method from the form's constructor or Load method.
private: void InitializeListView() { // Set up the inital values for the ListView and populate it. this->ListView1 = gcnew ListView; this->ListView1->Dock = DockStyle::Top; this->ListView1->Location = System::Drawing::Point( 0, 0 ); this->ListView1->Size = System::Drawing::Size( 292, 130 ); this->ListView1->View = View::Details; this->ListView1->FullRowSelect = true; array<String^>^breakfast = {"Continental Breakfast","Pancakes and Sausage","Denver Omelet","Eggs & Bacon","Bagel & Cream Cheese"}; array<String^>^breakfastPrices = {"3.09","4.09","4.19","4.79","2.09"}; PopulateMenu( "Breakfast", breakfast, breakfastPrices ); } void PopulateMenu( String^ meal, array<String^>^menuItems, array<String^>^menuPrices ) { ColumnHeader^ columnHeader1 = gcnew ColumnHeader; columnHeader1->Text = String::Concat( meal, " Choices" ); columnHeader1->TextAlign = HorizontalAlignment::Left; columnHeader1->Width = 146; ColumnHeader^ columnHeader2 = gcnew ColumnHeader; columnHeader2->Text = "Price"; columnHeader2->TextAlign = HorizontalAlignment::Center; columnHeader2->Width = 142; this->ListView1->Columns->Add( columnHeader1 ); this->ListView1->Columns->Add( columnHeader2 ); for ( int count = 0; count < menuItems->Length; count++ ) { ListViewItem^ listItem = gcnew ListViewItem( menuItems[ count ] ); listItem->SubItems->Add( menuPrices[ count ] ); ListView1->Items->Add( listItem ); } // Use the Selected property to select the first item on // the list. ListView1->Focus(); ListView1->Items[ 0 ]->Selected = true; } void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ ) { // Create new values for the ListView, clear the list, // and repopulate it. array<String^>^lunch = {"Hamburger","Grilled Cheese","Soup & Salad","Club Sandwich","Hotdog"}; array<String^>^lunchPrices = {"4.09","5.09","5.19","4.79","2.09"}; ListView1->Clear(); PopulateMenu( "Lunch", lunch, lunchPrices ); Button1->Enabled = false; }
Available since 1.1
