By default, the CountLockedColumns property is 0 (no locked columns), meaning no columns are locked and the property has no effect. The CountLockedColumns property allows locking columns on both sides using a single byte: the low 4 bits set left-locked columns, and the high 4 bits set right-locked columns. The CountLockedColumns property only applies to visible columns; hidden columns are not counted or locked. Previously, only left-side locking was supported. The Visible property specifies whether the column is visible or hidden. The ColumnAutoResize property enables or disables the automatic adjustment of column widths to match the available space (allow horizontal scroll-bar)
The control supports two types of columns: locked and unlocked.
- locked columns are fixed and do not scroll. They can be positioned on either the left or the right side of the control
- unlocked columns are scrollable and appear between the left- and right-locked columns
The CountLockedColumns property controls the number of locked columns on both sides of the view using a single byte in {high, low} format:
- the low nibble (bits 0-3, values 0-15) specifies the number of left-locked columns
- the high nibble (bits 4-7, values 0-15) specifies the number of right-locked columns
For instance:
- 2, locks first two visible columns on to the left
- 16 (0x10), locks 1 column on the right (locks the last visible-column)
- 17 (0x11), locks 1 column on the left and 1 on the right (locks the first and last visible columns)
To customize the appearance of the locked areas:
- use BackColorLock to set the background color
- use ForeColorLock to set the foreground color
Note: If CountLockedColumns property is set to 0 (no locked columns), the locked area is not displayed, and BackColorLock and ForeColorLock have no effect.
Additional options:
- use LockedItemCount to lock items (rows) to the top or bottom of the control
- use the MergeCells method to combine multiple cells into a single merged cell
The following screen shot shows the control when CountLockedColumns property is 0 (no locked columns):
