DataGridViewRow::Frozen Property

 

Gets or sets a value indicating whether the row is frozen.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public:
[BrowsableAttribute(false)]
property bool Frozen {
	virtual bool get() override;
	virtual void set(bool value) override;
}

Property Value

Type: System::Boolean

true if the row is frozen; otherwise, false.

Exception Condition
InvalidOperationException

The row is in a DataGridView control and is a shared row.

This property lets you keep one or several rows of important information in place when a user scrolls through the DataGridView. All rows above the frozen row are also frozen.

The following code example demonstrates how to use the DataGridViewBand::Frozen property, which is nearly identical to the Frozen property of the DataGridViewRow class. This code example is part of a larger example provided for the DataGridViewBand class.

// 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;
}


.NET Framework
Available since 2.0
Return to top
Show: