FreezeLeftCellName Property

Gets or sets the cell name used to freeze (do not scroll) the left side of the control.

Syntax

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

<DefaultValueAttribute()>
<MergablePropertyAttribute(False)>
<SRCategoryAttribute("Behavior")>
<SRDescriptionAttribute("Indicates the cell name to freeze (do not scroll) the control on the left side.")>
<TypeConverterAttribute("GrapeCity.Win.MultiRow.Design.CellNameTypeConverter, GrapeCity.Win.MultiRow, Version=7.20.20141.0, Culture=neutral, PublicKeyToken=0f7a722ee3c2bdd9")>
<RefreshPropertiesAttribute(RefreshProperties.All)>
Public Property FreezeLeftCellName As String

Dim instance As GcMultiRow
Dim value As String
 
instance.FreezeLeftCellName = value
 
value = instance.FreezeLeftCellName

[DefaultValue()]
[MergableProperty(false)]
[SRCategory("Behavior")]
[SRDescription("Indicates the cell name to freeze (do not scroll) the control on the left side.")]
[TypeConverter("GrapeCity.Win.MultiRow.Design.CellNameTypeConverter, GrapeCity.Win.MultiRow, Version=7.20.20141.0, Culture=neutral, PublicKeyToken=0f7a722ee3c2bdd9")]
[RefreshProperties(RefreshProperties.All)]
public string FreezeLeftCellName {get; set;}

Property Value

A System.String value that represents the cell name used to freeze the left side of the control. The default is String.Empty.

Example

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

void setLeftFreezeButton_Click(object sender, EventArgs e)
        {
            // You can use FreezeLeftCellIndex instead of FreezeLeftCellName to indicate which cell will be frozen.
            if (string.IsNullOrEmpty(this.gcMultiRow1.FreezeLeftCellName))
            {
                // Freeze some rows in top of gcMultiRow.
                this.gcMultiRow1.FreezeLeftCellName = "textBoxCell1";
                // this.gcMultiRow1.FreezeLeftCellIndex = 0;
            }
            else
            {
                // Unfreeze rows in top of gcMultiRow.
                this.gcMultiRow1.FreezeLeftCellName = string.Empty;
                // this.gcMultiRow1.FreezeLeftCellIndex = -1;
            }
        }

VB.NET

Private Sub setLeftFreezeButton_Click(ByVal sender As Object, ByVal e As EventArgs) Handles setLeftFreezeButton.Click
        ' You can use FreezeLeftCellIndex instead of FreezeLeftCellName to indicate which cell will be frozen.
        If String.IsNullOrEmpty(Me.gcMultiRow1.FreezeLeftCellName) Then
            ' Freeze some rows in top of gcMultiRow.
            ' this.gcMultiRow1.FreezeLeftCellIndex = 0;
            Me.gcMultiRow1.FreezeLeftCellName = "textBoxCell1"
        Else
            ' Unfreeze rows in top of gcMultiRow.
            ' this.gcMultiRow1.FreezeLeftCellIndex = -1;
            Me.gcMultiRow1.FreezeLeftCellName = String.Empty
        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
FreezeLeftCellIndex Property
FreezeLines Property