DataGridViewBand.Frozen Property

 

Gets or sets a value indicating whether the band will move when a user scrolls through the DataGridView.

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

public virtual bool Frozen { get; set; }

Property Value

Type: System.Boolean

true if the band cannot be scrolled from view; otherwise, false. The default is false.

This property can hold a band of important information in place when a user scrolls through the DataGridView. Bands adjacent to the frozen band will move over the frozen band.

The following code example freezes a band of cells in a column and a row. The example also changes the default cell style of the frozen bands to specify which bands are frozen. This code example is part of a larger example provided for the DataGridViewBand class.

// Freeze the first row.
private void Button4_Click(object sender, System.EventArgs e)
{

    FreezeBand(dataGridView.Rows[0]);
}

private void Button5_Click(object sender, System.EventArgs e)
{

    FreezeBand(dataGridView.Columns[1]);
}

private static void FreezeBand(DataGridViewBand band)
{
    band.Frozen = true;
    DataGridViewCellStyle style = new DataGridViewCellStyle();
    style.BackColor = Color.WhiteSmoke;
    band.DefaultCellStyle = style;
}

.NET Framework
Available since 2.0
Return to top
Show: