Split(Int32) メソッド

スクロール領域を２つに分割します。

シンタックス

Visual Basic

'宣言
 
Public Overloads Function Split( _
   ByVal extent As Integer _
) As RowScrollRegion

C#

public RowScrollRegion Split( 
   int extent
)

パラメータ

extent

範囲に 0 を指定すると、指定した領域は半分に分割されます。

戻り値の型

スプリットによって作成された新しい行スクロール領域。

解説

ひとつのスクローリング領域を2つのスクローリング領域に分割するために、このメソッドを起動します。このメソッドは、分割によって作成された新しいスクローリング領域に対応するColScrollRegionオブジェクトまたはRowScrollRegionオブジェクトを返します。

ColScrollRegions は既存の領域の左に表示する分割によって新しい領域を作成し、右から左に分割されます。RowScrollRegions は既存の領域の上に表示する分割によって新しい領域を作成し、下から上に分割されます。

ColScrollRegionを分割するときにwidthを指定すれば、新しい領域の幅を設定します (2つの結果のColScrollRegionsの左端)。RowScrollRegionを分割するときにheightを指定すれば、新しい領域の高さを設定します (2つの結果のRowScrollRegionsの上端)。

ColScrollRegion が分割されると、BeforeColRegionSplit および AfterColRegionSplit イベントが生成されます。RowsScrollRegion が分割されると、BeforeRowRegionSplit および AfterRowRegionSplit イベントが生成されます。

使用例

Visual Basic

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

C#

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;

}