DataGridViewBand Class
Represents a linear collection of elements in a DataGridView control.
System.Windows.Forms::DataGridViewElement
System.Windows.Forms::DataGridViewBand
System.Windows.Forms::DataGridViewColumn
System.Windows.Forms::DataGridViewRow
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
The DataGridViewBand type exposes the following members.
| Name | Description | |
|---|---|---|
![]() | ContextMenuStrip | Gets or sets the shortcut menu for the band. |
![]() | DataGridView | Gets the DataGridView control associated with this element. (Inherited from DataGridViewElement.) |
![]() | DefaultCellStyle | Gets or sets the default cell style of the band. |
![]() | DefaultHeaderCellType | Gets or sets the run-time type of the default header cell. |
![]() | Displayed | Gets a value indicating whether the band is currently displayed onscreen. |
![]() | Frozen | Gets or sets a value indicating whether the band will move when a user scrolls through the DataGridView. |
![]() | HasDefaultCellStyle | Gets a value indicating whether the DefaultCellStyle property has been set. |
![]() | HeaderCellCore | Gets or sets the header cell of the DataGridViewBand. |
![]() | Index | Gets the relative position of the band within the DataGridView control. |
![]() | InheritedStyle | Gets the cell style in effect for the current band, taking into account style inheritance. |
![]() | IsRow | Gets a value indicating whether the band represents a row. |
![]() | ReadOnly | Gets or sets a value indicating whether the user can edit the band's cells. |
![]() | Resizable | Gets or sets a value indicating whether the band can be resized in the user interface (UI). |
![]() | Selected | Gets or sets a value indicating whether the band is in a selected user interface (UI) state. |
![]() | State | Gets the user interface (UI) state of the element. (Inherited from DataGridViewElement.) |
![]() | Tag | Gets or sets the object that contains data to associate with the band. |
![]() | Visible | Gets or sets a value indicating whether the band is visible to the user. |
| Name | Description | |
|---|---|---|
![]() | Clone | Creates an exact copy of this band. |
![]() | Dispose() | Releases all resources used by the DataGridViewBand. |
![]() | Dispose(Boolean) | Releases the unmanaged resources used by the DataGridViewBand and optionally releases the managed resources. |
![]() | Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
![]() | Finalize | Releases the resources associated with the band. (Overrides Object::Finalize().) |
![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() | OnDataGridViewChanged | Called when the band is associated with a different DataGridView. (Overrides DataGridViewElement::OnDataGridViewChanged().) |
![]() | RaiseCellClick | Raises the DataGridView::CellClick event. (Inherited from DataGridViewElement.) |
![]() | RaiseCellContentClick | Raises the DataGridView::CellContentClick event. (Inherited from DataGridViewElement.) |
![]() | RaiseCellContentDoubleClick | Raises the DataGridView::CellContentDoubleClick event. (Inherited from DataGridViewElement.) |
![]() | RaiseCellValueChanged | Raises the DataGridView::CellValueChanged event. (Inherited from DataGridViewElement.) |
![]() | RaiseDataError | Raises the DataGridView::DataError event. (Inherited from DataGridViewElement.) |
![]() | RaiseMouseWheel | Raises the Control::MouseWheel event. (Inherited from DataGridViewElement.) |
![]() | ToString | Returns a string that represents the current band. (Overrides Object::ToString().) |
The DataGridViewBand class represents DataGridViewCell elements joined together in a band that can be manipulated as a group. Each element is typically an instance of DataGridViewCell or one of its derived classes. Although a DataGridViewHeaderCell is associated with each band, header cells are not considered elements of the band.
DataGridViewBand is the base class of the DataGridViewRow and DataGridViewColumn classes. There are no public constructors for the DataGridViewBand type, so the only way to access a band is through columns and rows in a DataGridView.
The following code example uses a DataGridViewBand to manipulate properties of groups of cells in a DataGridView.
#using <System.Drawing.dll> #using <System.dll> #using <system.windows.forms.dll> #using <system.drawing.dll> using namespace System::Drawing; using namespace System::Windows::Forms; using namespace System; using namespace System::Collections; public ref class DataGridViewBandDemo: public Form { private: #pragma region S " form setup " public: DataGridViewBandDemo() { Button1 = gcnew Button; Button2 = gcnew Button; Button3 = gcnew Button; Button4 = gcnew Button; Button5 = gcnew Button; Button6 = gcnew Button; Button7 = gcnew Button; Button8 = gcnew Button; Button9 = gcnew Button; Button10 = gcnew Button; FlowLayoutPanel1 = gcnew FlowLayoutPanel; InitializeComponent(); thirdColumnHeader = L"Main Ingredients"; boringMeatloaf = L"ground beef"; boringMeatloafRanking = L"*"; AddButton( Button1, L"Reset", gcnew EventHandler( this, &DataGridViewBandDemo::Button1_Click ) ); AddButton( Button2, L"Change Column 3 Header", gcnew EventHandler( this, &DataGridViewBandDemo::Button2_Click ) ); AddButton( Button3, L"Change Meatloaf Recipe", gcnew EventHandler( this, &DataGridViewBandDemo::Button3_Click ) ); AddAdditionalButtons(); InitializeDataGridView(); } DataGridView^ dataGridView; Button^ Button1; Button^ Button2; Button^ Button3; Button^ Button4; Button^ Button5; Button^ Button6; Button^ Button7; Button^ Button8; Button^ Button9; Button^ Button10; FlowLayoutPanel^ FlowLayoutPanel1; private: void InitializeComponent() { FlowLayoutPanel1->Location = Point(454,0); FlowLayoutPanel1->AutoSize = true; FlowLayoutPanel1->FlowDirection = FlowDirection::TopDown; AutoSize = true; ClientSize = System::Drawing::Size( 614, 360 ); FlowLayoutPanel1->Name = L"flowlayoutpanel"; Controls->Add( this->FlowLayoutPanel1 ); Text = this->GetType()->Name; } #pragma endregion #pragma region S " setup DataGridView " String^ thirdColumnHeader; String^ boringMeatloaf; String^ boringMeatloafRanking; bool boringRecipe; Boolean shortMode; void InitializeDataGridView() { dataGridView = gcnew System::Windows::Forms::DataGridView; Controls->Add( dataGridView ); dataGridView->Size = System::Drawing::Size( 300, 200 ); // Create an unbound DataGridView by declaring a // column count. dataGridView->ColumnCount = 4; AdjustDataGridViewSizing(); // Set the column header style. DataGridViewCellStyle^ columnHeaderStyle = gcnew DataGridViewCellStyle; columnHeaderStyle->BackColor = Color::Aqua; columnHeaderStyle->Font = gcnew System::Drawing::Font( L"Verdana",10,FontStyle::Bold ); dataGridView->ColumnHeadersDefaultCellStyle = columnHeaderStyle; // Set the column header names. dataGridView->Columns[ 0 ]->Name = L"Recipe"; dataGridView->Columns[ 1 ]->Name = L"Category"; dataGridView->Columns[ 2 ]->Name = thirdColumnHeader; dataGridView->Columns[ 3 ]->Name = L"Rating"; // Populate the rows. array<String^>^row1 = gcnew array<String^>{ L"Meatloaf",L"Main Dish",boringMeatloaf,boringMeatloafRanking }; array<String^>^row2 = gcnew array<String^>{ L"Key Lime Pie",L"Dessert",L"lime juice, evaporated milk",L"****" }; array<String^>^row3 = gcnew array<String^>{ L"Orange-Salsa Pork Chops",L"Main Dish",L"pork chops, salsa, orange juice",L"****" }; array<String^>^row4 = gcnew array<String^>{ L"Black Bean and Rice Salad",L"Salad",L"black beans, brown rice",L"****" }; array<String^>^row5 = gcnew array<String^>{ L"Chocolate Cheesecake",L"Dessert",L"cream cheese",L"***" }; array<String^>^row6 = gcnew array<String^>{ L"Black Bean Dip",L"Appetizer",L"black beans, sour cream",L"***" }; array<Object^>^rows = gcnew array<Object^>{ row1,row2,row3,row4,row5,row6 }; System::Collections::IEnumerator^ myEnum = rows->GetEnumerator(); while ( myEnum->MoveNext() ) { array<String^>^rowArray = safe_cast<array<String^>^>(myEnum->Current); dataGridView->Rows->Add( rowArray ); } PostRowCreation(); shortMode = false; boringRecipe = true; } void AddButton( Button^ button, String^ buttonLabel, EventHandler^ handler ) { FlowLayoutPanel1->Controls->Add( button ); button->TabIndex = FlowLayoutPanel1->Controls->Count; button->Text = buttonLabel; button->AutoSize = true; button->Click += handler; } // Reset columns to initial disorderly arrangement. void Button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ ) { Controls->Remove( dataGridView ); dataGridView->~DataGridView(); InitializeDataGridView(); } // Change the header in column three. void Button2_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ ) { Toggle( &shortMode ); if ( shortMode ) { dataGridView->Columns[ 2 ]->HeaderText = L"S"; } else { dataGridView->Columns[ 2 ]->HeaderText = thirdColumnHeader; } } void Toggle( interior_ptr<Boolean> toggleThis ) { *toggleThis = ! *toggleThis; } // Change the meatloaf recipe. void Button3_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ ) { Toggle( &boringRecipe ); if ( boringRecipe ) { SetMeatloaf( boringMeatloaf, boringMeatloafRanking ); } else { String^ greatMeatloafRecipe = L"1 lb. lean ground beef, " L"1/2 cup bread crumbs, 1/4 cup ketchup," L"1/3 tsp onion powder, " L"1 clove of garlic, 1/2 pack onion soup mix " L" dash of your favorite BBQ Sauce"; SetMeatloaf( greatMeatloafRecipe, L"***" ); } } void SetMeatloaf( String^ recipe, String^ rating ) { dataGridView->Rows[ 0 ]->Cells[ 2 ]->Value = recipe; dataGridView->Rows[ 0 ]->Cells[ 3 ]->Value = rating; } #pragma endregion #pragma region S " demonstration code " void AddAdditionalButtons() { AddButton( Button4, L"Freeze First Row", gcnew EventHandler( this, &DataGridViewBandDemo::Button4_Click ) ); AddButton( Button5, L"Freeze Second Column", gcnew EventHandler( this, &DataGridViewBandDemo::Button5_Click ) ); AddButton( Button6, L"Hide Salad Row", gcnew EventHandler( this, &DataGridViewBandDemo::Button6_Click ) ); AddButton( Button7, L"Disable First Column Resizing", gcnew EventHandler( this, &DataGridViewBandDemo::Button7_Click ) ); AddButton( Button8, L"Make ReadOnly", gcnew EventHandler( this, &DataGridViewBandDemo::Button8_Click ) ); AddButton( Button9, L"Style Using Tag", gcnew EventHandler( this, &DataGridViewBandDemo::Button9_Click ) ); } void AdjustDataGridViewSizing() { dataGridView->AutoSizeRowsMode = DataGridViewAutoSizeRowsMode::AllCells; dataGridView->ColumnHeadersHeightSizeMode = DataGridViewColumnHeadersHeightSizeMode::AutoSize; } // Freeze the first row. void Button4_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ ) { FreezeBand( dataGridView->Rows[ 0 ] ); } void Button5_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ ) { FreezeBand( dataGridView->Columns[ 1 ] ); } void FreezeBand( DataGridViewBand^ band ) { band->Frozen = true; DataGridViewCellStyle^ style = gcnew DataGridViewCellStyle; style->BackColor = Color::WhiteSmoke; band->DefaultCellStyle = style; } // Hide a band of cells. void Button6_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ ) { DataGridViewBand^ band = dataGridView->Rows[ 3 ]; band->Visible = false; } // Turn off user's ability to resize a column. void Button7_Click( Object^ /*sender*/, EventArgs^ /*e*/ ) { DataGridViewBand^ band = dataGridView->Columns[ 0 ]; band->Resizable = DataGridViewTriState::False; } // Make the the entire DataGridView read only. void Button8_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ ) { System::Collections::IEnumerator^ myEnum = dataGridView->Columns->GetEnumerator(); while ( myEnum->MoveNext() ) { DataGridViewBand^ band = safe_cast<DataGridViewBand^>(myEnum->Current); band->ReadOnly = true; } } void PostRowCreation() { SetBandColor( dataGridView->Columns[ 0 ], Color::CadetBlue ); SetBandColor( dataGridView->Rows[ 1 ], Color::Coral ); SetBandColor( dataGridView->Columns[ 2 ], Color::DodgerBlue ); } void SetBandColor( DataGridViewBand^ band, Color color ) { band->Tag = color; } // Color the bands by the value stored in their tag. void Button9_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ ) { IEnumerator^ myEnum1 = dataGridView->Columns->GetEnumerator(); while ( myEnum1->MoveNext() ) { DataGridViewBand^ band = static_cast<DataGridViewBand^>(myEnum1->Current); if ( band->Tag != nullptr ) { band->DefaultCellStyle->BackColor = *dynamic_cast<Color^>(band->Tag); } } IEnumerator^ myEnum2 = safe_cast<IEnumerable^>(dataGridView->Rows)->GetEnumerator(); while ( myEnum2->MoveNext() ) { DataGridViewBand^ band = safe_cast<DataGridViewBand^>(myEnum2->Current); if ( band->Tag != nullptr ) { band->DefaultCellStyle->BackColor = *dynamic_cast<Color^>(band->Tag); } } } #pragma endregion public: static void Main() { Application::Run( gcnew DataGridViewBandDemo ); } }; int main() { DataGridViewBandDemo::Main(); }
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
