BeforeColRegionSplit イベント

列スクロール領域が二つの列スクロール領域にスプリットされる前に発生します。

シンタックス

Visual Basic

'宣言
 
Public Event BeforeColRegionSplit As BeforeColRegionSplitEventHandler

C#

public event BeforeColRegionSplitEventHandler BeforeColRegionSplit

イベント データ

イベント ハンドラが、このイベントに関連するデータを含む、BeforeColRegionSplitEventArgs 型の引数を受け取りました。次の BeforeColRegionSplitEventArgs プロパティには、このイベントの固有の情報が記載されます。

プロパティ	解説
Cancel System.ComponentModel.CancelEventArgsから継承されます。
NewColScrollRegion	新しい列スクロール領域を返します。
OriginalColScrollRegion	元の列スクロール領域を返します。

解説

originalcolscrollregion 引数は、プロパティを設定でき、分割前に存在する colscrollregion でメソッドを呼び出す ColScrollRegion オブジェクトへの参照を返します。この参照を使用して、返される colscrollregion のプロパティまたはメソッドにアクセスできます。ただし、この colscrollregion の Position および Width プロパティは、イベント プロシージャーでは読み取り専用です。

newcolscrollregion 引数は、プロパティを設定でき、分割後に存在する colscrollregion でメソッドを呼び出す ColScrollRegion オブジェクトへの参照を返します。この参照を使用して、返される colscrollregion のプロパティまたはメソッドにアクセスできます。

cancel 引数を使用して、colscrollregion が分割されないようにプログラミングできます。一定の条件が満たされない限り、ユーザーが colscrollregion を分割することができないようにすることが可能です。

このイベントは、ユーザーによる操作、またはプログラム操作で colscrollregion が分割される前に生成されます。colscrollregion は、Split メソッドを起動してプログラムで分割できます。

BeforeColRegionRemoved イベントは、colscrollregion が削除される前に生成されます。

BeforeColRegionSize イベントは、colscrollregion がサイズ設定される前に生成されます。

BeforeRowRegionSplit イベントは、rowscrollregion が分割される前に生成されます。

使用例

Visual Basic

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

  Private Sub UltraGrid1_BeforeColRegionSplit(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinGrid.BeforeColRegionSplitEventArgs) Handles ultraGrid1.BeforeColRegionSplit

      ' 新しいスクロール領域が 100 ピクセルより小さい場合、
      ' UltraGrid が分割された領域へスクロールしないようにイベントをキャンセルします
      If e.NewColScrollRegion.Width < 100 Then
          e.Cancel = True

          ' 列のスクロール領域を分割すると、100 ピクセルより小さくなる場合も
          ' キャンセルします
      ElseIf e.OriginalColScrollRegion.Width - e.NewColScrollRegion.Width < 100 Then
          e.Cancel = True
      End If

      If e.Cancel Then
          MessageBox.Show("You cannot split a column scroll region smaller than 100 pixels.")
      End If

  End Sub

  Private Sub UltraGrid1_BeforeColRegionSize(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinGrid.BeforeColRegionSizeEventArgs) Handles ultraGrid1.BeforeColRegionSize

      ' 影響されるスクロール領域が 100 ピクセルより小さくなるサイズ変更がある場合、
      ' サイズ変更をキャンセルします			
      If e.Region1.Width < 100 Or e.Region2.Width < 100 Then
          e.Cancel = True
          MessageBox.Show("You cannot resize a column scroll region smaller than 100 pixels.")
      End If

  End Sub

C#

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

private void ultraGrid1_BeforeColRegionSplit(object sender, Infragistics.Win.UltraWinGrid.BeforeColRegionSplitEventArgs e)
{
	// 新しいスクロール領域が 100 ピクセルより小さい場合、
	// UltraGrid が分割された領域へスクロールしないようにイベントをキャンセルします
	if ( e.NewColScrollRegion.Width < 100 )
		e.Cancel = true;

	// 列のスクロール領域を分割すると、100 ピクセルより小さくなる場合、
	// キャンセルします
	else if ( e.OriginalColScrollRegion.Width - e.NewColScrollRegion.Width < 100 )
		e.Cancel = true;

	if ( e.Cancel )
	{
		MessageBox.Show( "You cannot split a column scroll region smaller than 100 pixels." );
	}
}

private void ultraGrid1_BeforeColRegionSize(object sender, Infragistics.Win.UltraWinGrid.BeforeColRegionSizeEventArgs e)
{
	// 影響されるスクロール領域が 100 ピクセルより小さくなるサイズ変更がある場合、
	// サイズ変更をキャンセルします			
	if ( e.Region1.Width < 100 || e.Region2.Width < 100 )
	{
		e.Cancel = true;

		MessageBox.Show( "You cannot resize a column scroll region smaller than 100 pixels." );
	}
}