FreezeTopRowCount Property

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

Syntax

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

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

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

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

Property Value

A System.Int32 value that represents the frozen row count in the top 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 RowCount, GcMultiRow freezes all of the rows in the control. When the row count is greater than this property's value, nonfrozen rows appear.

If the total height of the frozen rows (includes 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 in the MulitRow control. This code example is part of a larger example provided for the FreezeLines property.

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

VB.NET

Private Sub setTopFreezButton_Click(ByVal sender As Object, ByVal e As EventArgs) Handles setTopFreezButton.Click
        If Me.gcMultiRow1.FreezeTopRowCount = 0 Then
            ' Freeze some rows in top of gcMultiRow.
            Me.gcMultiRow1.FreezeTopRowCount = 2
        Else
            ' Unfreeze rows in top of gcMultiRow.
            Me.gcMultiRow1.FreezeTopRowCount = 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
FreezeBottomRowCount Property
FreezeLines Property