Intersoft WebGrid Documentation
ActiveFrozenColumns Property
See Also  Send Feedback
ISNet.WebUI.WebGrid Namespace > WebGridFreezePaneSettings Class : ActiveFrozenColumns Property






Gets or sets the number column (based on zero-index position) to be set as active frozen columns.

Syntax

Visual Basic (Declaration) 
<ISNet.Serialization.XmlSerializableAttribute()>
<ISNet.Serialization.BinarySerializableAttribute()>
<DescriptionAttribute("Gets or sets the number of columns (based on zero-index position) to be set as active frozen columns.")>
<DefaultValueAttribute()>
<NotifyParentPropertyAttribute(True)>
Public Property ActiveFrozenColumns As Integer
Visual Basic (Usage)Copy Code
Dim instance As WebGridFreezePaneSettings
Dim value As Integer
 
instance.ActiveFrozenColumns = value
 
value = instance.ActiveFrozenColumns
C# 
[ISNet.Serialization.XmlSerializableAttribute()]
[ISNet.Serialization.BinarySerializableAttribute()]
[DescriptionAttribute("Gets or sets the number of columns (based on zero-index position) to be set as active frozen columns.")]
[DefaultValueAttribute()]
[NotifyParentPropertyAttribute(true)]
public int ActiveFrozenColumns {get; set;}
Delphi 
public read-write property ActiveFrozenColumns: Integer; 
JScript 
ISNet.Serialization.XmlSerializableAttribute()
ISNet.Serialization.BinarySerializableAttribute()
DescriptionAttribute("Gets or sets the number of columns (based on zero-index position) to be set as active frozen columns.")
DefaultValueAttribute()
NotifyParentPropertyAttribute()
public function get,set ActiveFrozenColumns : int
Managed Extensions for C++ 
[ISNet.Serialization.XmlSerializableAttribute()]
[ISNet.Serialization.BinarySerializableAttribute()]
[DescriptionAttribute("Gets or sets the number of columns (based on zero-index position) to be set as active frozen columns.")]
[DefaultValueAttribute()]
[NotifyParentPropertyAttribute(true)]
public: __property int get_ActiveFrozenColumns();
public: __property void set_ActiveFrozenColumns( 
   int value
);
C++/CLI 
[ISNet.Serialization.XmlSerializableAttribute()]
[ISNet.Serialization.BinarySerializableAttribute()]
[DescriptionAttribute("Gets or sets the number of columns (based on zero-index position) to be set as active frozen columns.")]
[DefaultValueAttribute()]
[NotifyParentPropertyAttribute(true)]
public:
property int ActiveFrozenColumns {
   int get();
   void set (    int value);
}

Remarks

This property defines how many columns are frozen in initial page load. The default value is 0, which means no frozen columns need to be configured. The value of ActiveFrozenColumns property determines the number of visible columns to be frozen in respective columns order. For example, if you have a WebGrid with columns "FirstName, LastName, ContactTitle" and LastName's Visible is set to False and ActiveFrozenColumns set to 2, then the active frozen columns would be "FirstName" and "ContactTitle".

It is best practice to keep the ActiveFrozenColumns property to a value where the column freezing feature may deliver best results in user experience. For instance, if you set ActiveFrozenColumns to a value exceeding half of the columns length, then the column freezing display might not be useful.

For more information you can read How-to: Allow User to Freeze/Unfreeze at runtime.

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

©2012 Intersoft Solutions Corp. All Rights Reserved.