InitializeLayout イベント (UltraDropDown)

データソースからコントロールにデータが読み込みされるときなど、表示レイアウトが初期化されるときに発生します。

シンタックス

Visual Basic

'宣言
 
Public Event InitializeLayout As InitializeLayoutEventHandler

C#

public event InitializeLayoutEventHandler InitializeLayout

イベント データ

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

プロパティ	解説
Layout	UltraGridLayout

解説

InitializeLayoutEventArgs.Layout 引数は、プロパティを設定でき、コントロールのレイアウトでメソッドを呼び出す UltraGridBase.DisplayLayout オブジェクトへの参照を返します。この参照を使用して、返されたレイアウトのプロパティを設定したり、メソッドを呼び出したりすることができます。

このイベントはフォームの Load イベントと同じように、コントロールが表示される前にコントロールを設定する機会を提供します。このイベント プロシージャーでは、たとえば外観、値リスト、アンバインド列などを作成する処理を実行します。

このイベントは、コントロールが初めてデータソースからのデータを表示するときに生成されます。データソースが変更されたときに発生することもあります。

使用例

Visual Basic

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

  Private Sub UltraDropDown1_InitializeLayout(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinGrid.InitializeLayoutEventArgs) Handles ultraDropDown1.InitializeLayout

      ' ユーザーがスクロールつまみでドロップダウンをスクロールするときに 
      ' 行を直ちにスクロールするために、スクロール スタイルを immediate に設定します
      e.Layout.ScrollStyle = ScrollStyle.Immediate

      ' UltraDropDown で列を表示する順序を変更します
      e.Layout.Bands(0).Columns("ProductID").Header.VisiblePosition = 0
      e.Layout.Bands(0).Columns("ProductName").Header.VisiblePosition = 1

      ' 表示しない列は非表示にします
      e.Layout.Bands(0).Columns("UnitsOnOrder").Hidden = True

      ' ドロップダウンの項目を ProductName 列で並べ替えます
      e.Layout.Bands(0).SortedColumns.Clear()
      e.Layout.Bands(0).SortedColumns.Add("ProductName", False)

      ' ドロップダウンの境界線スタイルを設定します
      e.Layout.BorderStyle = UIElementBorderStyle.Solid

  End Sub

C#

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

private void ultraDropDown1_InitializeLayout(object sender, Infragistics.Win.UltraWinGrid.InitializeLayoutEventArgs e)
{

	// ユーザーがスクロールつまみでドロップダウンをスクロールするときに、 
	// 行を直ちにスクロールするために、スクロール スタイルを immediate に設定します
	e.Layout.ScrollStyle = ScrollStyle.Immediate;

	// UltraDropDown で列を表示する順序を変更します
	e.Layout.Bands[0].Columns["ProductID"].Header.VisiblePosition = 0;
	e.Layout.Bands[0].Columns["ProductName"].Header.VisiblePosition = 1;

	// 表示しない列を非表示にします
	e.Layout.Bands[0].Columns["UnitsOnOrder"].Hidden = true;

	// ドロップダウンの項目を ProductName 列によって並べ替えます
	e.Layout.Bands[0].SortedColumns.Clear( );
	e.Layout.Bands[0].SortedColumns.Add( "ProductName", false );

	// ドロップダウンの境界線スタイルを設定します
	e.Layout.BorderStyle = UIElementBorderStyle.Solid;	
		
}