Version

MaxColScrollRegions Property

Returns or sets the maximum number of column scrolling regions.
Syntax
'Declaration
 
Public Property MaxColScrollRegions As Integer
public int MaxColScrollRegions {get; set;}
Remarks

The MaxColScrollRegions property can be used to limit the number of column scrolling regions that may be present at one time in the UltraWinGrid. When the maximum number of regions has been created, no more may be added either through code or by using the user interface of the grid.

The default setting of this property is 10. The minimum setting for this property is 1.

Example
Following code sets up the ultraGrid1 with 2 colum-scroll-regions and two row-scroll-regions and thus having a total of four row-col-intersection regions.

Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid

  Private Sub Button5_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button5.Click

      ' Split the column-scroll-region and the row-scroll-region each.
      Me.ultraGrid1.DisplayLayout.ColScrollRegions(0).Split()
      Me.ultraGrid1.DisplayLayout.RowScrollRegions(0).Split()

      ' Set the max regions the grid can have preventing the user from splitting
      ' any more than the max.
      Me.ultraGrid1.DisplayLayout.MaxColScrollRegions = 2
      Me.ultraGrid1.DisplayLayout.MaxRowScrollRegions = 2

      ' Set the sizing mode to Fixed, so the user can't resize the scroll regions.
      Me.ultraGrid1.DisplayLayout.RowScrollRegions(0).SizingMode = SizingMode.Fixed
      Me.ultraGrid1.DisplayLayout.RowScrollRegions(1).SizingMode = SizingMode.Fixed
      Me.ultraGrid1.DisplayLayout.ColScrollRegions(0).SizingMode = SizingMode.Fixed
      Me.ultraGrid1.DisplayLayout.ColScrollRegions(1).SizingMode = SizingMode.Fixed

  End Sub
using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinGrid;
using System.Diagnostics;

private void button5_Click(object sender, System.EventArgs e)
{

	// Split the column-scroll-region and the row-scroll-region each.
	this.ultraGrid1.DisplayLayout.ColScrollRegions[0].Split( );
	this.ultraGrid1.DisplayLayout.RowScrollRegions[0].Split( );

	// Set the max regions the grid can have preventing the user from splitting
	// any more than the max.
	this.ultraGrid1.DisplayLayout.MaxColScrollRegions = 2;
	this.ultraGrid1.DisplayLayout.MaxRowScrollRegions = 2;

	// Set the sizing mode to Fixed, so the user can't resize the scroll regions.
	this.ultraGrid1.DisplayLayout.RowScrollRegions[0].SizingMode = SizingMode.Fixed;
	this.ultraGrid1.DisplayLayout.RowScrollRegions[1].SizingMode = SizingMode.Fixed;
	this.ultraGrid1.DisplayLayout.ColScrollRegions[0].SizingMode = SizingMode.Fixed;
	this.ultraGrid1.DisplayLayout.ColScrollRegions[1].SizingMode = SizingMode.Fixed;

}
Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, 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

See Also