FreezeBottomRowCount Property

Gets or sets the frozen row count (rows that do not scroll) at the bottom of the GcMultiRow control.

Syntax

Visual Basic (Declaration)
Visual Basic (Usage)
C#

<DefaultValueAttribute()>
<SRDescriptionAttribute("Indicates the number of the bottom frozen rows.")>
<SRCategoryAttribute("Behavior")>
Public Property FreezeBottomRowCount As Integer

Dim instance As GcMultiRow
Dim value As Integer
 
instance.FreezeBottomRowCount = value
 
value = instance.FreezeBottomRowCount

[DefaultValue()]
[SRDescription("Indicates the number of the bottom frozen rows.")]
[SRCategory("Behavior")]
public int FreezeBottomRowCount {get; set;}

Property Value

A System.Int32 value that represents the frozen row count in the bottom of the GcMultiRow control. The default is 0.

Exceptions

Exception	Description
System.ArgumentOutOfRangeException	The specified value is less than 0.

Remarks

If this property's value is more than the RowCount minus the FreezeTopRowCount, the GcMultiRow control freezes all of the rows in the control. When the row count minus the FreezeTopRowCount is more than this property's value, nonfrozen rows appear.

If the total height of the frozen rows (including top frozen rows and bottom frozen rows) is greater than the height of the control's row area, the whole control is frozen. This situation should be avoided.

Example

The following code example shows how to use this property to freeze rows. This code example is part of a larger example provided for the FreezeLines property.

void setBottomFreezeButton_Click(object sender, EventArgs e)
        {
            if (this.gcMultiRow1.FreezeBottomRowCount == 0)
            {
                // Freeze some rows in bottom of gcMultiRow.
                this.gcMultiRow1.FreezeBottomRowCount = 2;
            }
            else
            {
                // Unfreeze rows in bottom of gcMultiRow.
                this.gcMultiRow1.FreezeBottomRowCount = 0;
            }
        }

VB.NET

Private Sub setBottomFreezeButton_Click(ByVal sender As Object, ByVal e As EventArgs) Handles setBottomFreezeButton.Click
        If Me.gcMultiRow1.FreezeBottomRowCount = 0 Then
            ' Freeze some rows in bottom of gcMultiRow.
            Me.gcMultiRow1.FreezeBottomRowCount = 2
        Else
            ' Unfreeze rows in bottom of gcMultiRow.
            Me.gcMultiRow1.FreezeBottomRowCount = 0
        End If
    End Sub

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

GcMultiRow Class
GcMultiRow Members
FreezeTopRowCount Property
FreezeLines Property