AfterGroupPosChanged イベント

UltraGridGroupオブジェクトの移動、サイズ設定、または交換が行われた後に発生します。

シンタックス

Visual Basic

'宣言
 
Public Event AfterGroupPosChanged As AfterGroupPosChangedEventHandler

C#

public event AfterGroupPosChangedEventHandler AfterGroupPosChanged

イベント データ

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

プロパティ	解説
GroupHeaders	グループ (読み取り専用)
GroupPosChangedType	ヘッダー位置が変更されたタイプ (読み取り専用)

解説

action 引数は、グループに対して実行された操作 (移動、入れ替え、サイズ変更) を示します。

groups 引数は、移動、入れ替え、またはサイズ変更された UltraGridGroup オブジェクトへの参照を取得するために使用できる Groups コレクションへの参照を返します。この参照を使用して、返されたコレクションのプロパティまたはメソッドだけでなく、コレクション内のオブジェクトのプロパティまたはメソッドにもアクセスできます。

このイベントは、プログラムまたはユーザーの操作によって 1 つ以上のグループが移動、入れ替え、またはサイズ変更された後に発生します。グループをプログラムからサイズ変更するには、その Width プロパティを設定します。プログラムから移動するには、そのヘッダーの VisiblePosition プロパティを設定します。

グループ ヘッダーの VisiblePosition プロパティは、移動または入れ替えられたグループの新しい位置を確認するために使用できます。

ユーザーがグループを移動または入れ替えできないようにするには、それぞれ AllowGroupMoving または AllowGroupSwapping プロパティを設定します。

AfterColPosChanged イベントは、1 つ以上の列が移動、入れ替え、またはサイズ変更された後に発生します。

BeforeGroupPosChanged イベントは、ひとつ以上のグループが移動、入れ替え、またはサイズ変更される前に発生します。

使用例

Visual Basic

Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid
Imports System.Diagnostics

   Private Sub UltraGrid1_AfterGroupPosChanged(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinGrid.AfterGroupPosChangedEventArgs) Handles ultraGrid1.AfterGroupPosChanged

       ' ユーザーがグループを移動、入れ替え、またはサイズ変更した後に AfterGroupPosChanged を
       ' 発生します

       If PosChanged.Moved = e.PosChanged Then
           ' 1 つ以上のグループが移動されました

           Debug.WriteLine("Following are the new positions of the groups:")

           Dim i As Integer
           For i = 0 To e.GroupHeaders.Length - 1
               Debug.WriteLine("    " & e.GroupHeaders(i).Caption & " is moved to the new visible index of " & e.GroupHeaders(i).VisiblePosition)
           Next
       ElseIf PosChanged.Swapped = e.PosChanged Then
           ' 2 つのグループが入れ替えられています

           Debug.WriteLine(e.GroupHeaders(0).Caption & " and " & e.GroupHeaders(1).Caption & " groups have been swapped.")
       ElseIf PosChanged.Sized = e.PosChanged Then
           ' グループがサイズ変更されました

           Debug.WriteLine(e.GroupHeaders(0).Caption & " has been resized to the new width of " & e.GroupHeaders(0).Caption)
       End If

   End Sub

C#

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

private void ultraGrid1_AfterGroupPosChanged(object sender, Infragistics.Win.UltraWinGrid.AfterGroupPosChangedEventArgs e)
{

	// ユーザーがグループを移動、入れ替え、サイズ変更した後に AfterGroupPosChanged を
	// 発生します
	
	if ( PosChanged.Moved == e.PosChanged )
	{	
		// 1 つ以上のグループが移動されています

		Debug.WriteLine( "Following are the new positions of the groups:" );

		for ( int i = 0; i < e.GroupHeaders.Length; i++ )
		{										
			Debug.WriteLine( "    " + e.GroupHeaders[i].Caption + 
				" is moved to the new visible index of " + e.GroupHeaders[i].VisiblePosition );
		}
	}
	else if ( PosChanged.Swapped == e.PosChanged )
	{
		// 2 つのグループが入れ替えられています

		Debug.WriteLine( e.GroupHeaders[0].Caption + " and " + e.GroupHeaders[1].Caption 
			+ " groups have been swapped." );
	}
	else if ( PosChanged.Sized == e.PosChanged )
	{
		// グループがサイズ変更されています

		Debug.WriteLine( e.GroupHeaders[0].Caption + 
			" has been resized to the new width of " + e.GroupHeaders[0].Caption );
	}

}