FreezeColumnsCount Property

Description

Gets/Sets the number of columns that are frozen when the grid is scrolled horizontally.

Property Type

Read-write property

Syntax (Visual Basic)

Public Property FreezeColumnsCount() As Long

Remarks

FreezeColumnsCount holds the number of columns that are currently frozen. You can only freeze columns on the left of the grid, and you cannot freeze more columns than are displayed in the grid.

By freezing a column, the column will not scroll when scrolling horizontally. You can only freeze columns starting at the left-most side of the grid. Multiple columns can be frozen, but they must be in consecutive order starting from the left.

Automatic column sizing must be disabled to freeze columns; with automatic column sizing enabled, there will never be a horizontal scroll bar.

The animation below illustrates a grid where the first 3 columns are frozen. Notice how they do not move as the grid is scrolled horizontally left and right.

Grid Animation

Example

Freeze Columns Sample (Visual Basic)

This sample illustrates how to freeze columns on the left side of the grid while the grid is scrolled horizontally.

wndGridControl.AutoColumnSizing = False  
wndGridControl.FreezeColumnsCount = 3