Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version

Split(Int32) Method

Splits a scrolling region into two scrolling regions.
Syntax
'Declaration
 
Public Overloads Function Split( _
   ByVal extent As Integer _
) As ColScrollRegion
public ColScrollRegion Split( 
   int extent
)

Parameters

extent
Specifying 0 for extent will split the specified region in half.
Remarks

Invoke this method to split one scrolling region into two scrolling regions. This method returns a ColScrollRegion object or a RowScrollRegion object that corresponds to the new scrolling region that is created by the split.

ColScrollRegions are split from right to left, with the new region created by the split appearing to the left of the existing region. RowScrollRegions are split from bottom to top, with the new region created by the split appearing above the existing region.

Specifying width when splitting a ColScrollRegion will set the width of the new region (leftmost of the two resulting ColScrollRegions.) Specifying height when splitting a RowScrollRegion will set the height of the new region (topmost of the two resulting RowScrollRegions.)

When a ColScrollRegion is split, the BeforeColRegionSplit and the AfterColRegionSplit events are generated. When a RowsScrollRegion is split, the BeforeRowRegionSplit and the AfterRowRegionSplit events are generated.

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