InitializeGroupByRow イベント

GroupBy行が初期化された場合に発生します。

シンタックス

Visual Basic

'宣言
 
Public Event InitializeGroupByRow As InitializeGroupByRowEventHandler

C#

public event InitializeGroupByRowEventHandler InitializeGroupByRow

イベント データ

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

プロパティ	解説
ReInitialize	行がすでに初期化されている場合、Trueを返します。
Row	初期化されているGroupBy行を返します。

解説

Band が GroupBy モードの場合、GroupByRows の下でデータの行がグループ化され、行のグループに対する一時的なヘッダーとしての役割を果たします。GroupBy 行は、UltraGridGroupByRow オブジェクトを使用してコードから操作できる独自の属性を持ちます。GroupByRowInitialize イベントは、これらの GroupBy rows のひとつが作成されると発生し、表示前に GroupBy 行で作業する機会が与えられます。

使用例

Visual Basic

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

   Private Sub UltraGrid1_InitializeGroupByRow(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinGrid.InitializeGroupByRowEventArgs) Handles ultraGrid1.InitializeGroupByRow

       ' ReInitialize indicates whether the row is being initialized for the first time
       ' or it's being re-initialized.
       If e.ReInitialize Then
           Debug.WriteLine("A group-by row is being re-initilaized.")
       Else
           Debug.WriteLine("A group-by row is being initilaized.")
       End If

       ' Set the description to desired value. This is the text that shows up on
       ' the group-by row.
       e.Row.Description = e.Row.Value.ToString() & ", " & e.Row.Rows.Count & " Items."

       ' We only want to do this if we are grouping by the Country column.
       If e.Row.Column.Key = "Country" Then
           ' If the group has more than 5 items, then make the background color 
           ' of the row to red
           If e.Row.Rows.Count > 5 Then
               e.Row.Appearance.BackColor = Color.Red
           Else
               e.Row.Appearance.ResetBackColor()
           End If
       End If

   End Sub

C#

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

private void ultraGrid1_InitializeGroupByRow(object sender, Infragistics.Win.UltraWinGrid.InitializeGroupByRowEventArgs e)
{

	// ReInitialize indicates whether the row is being initialized for the first time
	// or it's being re-initialized.
	if ( e.ReInitialize )
		Debug.WriteLine( "A group-by row is being re-initilaized." );
	else
		Debug.WriteLine( "A group-by row is being initilaized." );

	// Set the description to desired value. This is the text that shows up on
	// the group-by row.
	e.Row.Description = e.Row.Value.ToString( ) + ", " + e.Row.Rows.Count + " Items.";

	// We only want to do this if we are grouping by the Country column.
	if ( e.Row.Column.Key == "Country" )
	{
		// If the group has more than 5 items, then make the background color 
		// of the row to red
		if ( e.Row.Rows.Count > 5 )
		{
			e.Row.Appearance.BackColor = Color.Red;
		}
		else
		{
			e.Row.Appearance.ResetBackColor( );
		}
	}

}