BeforeRowFilterDropDownPopulate イベント

行フィルタードロップダウンに値が読み込まれる前に呼び出されます。

シンタックス

Visual Basic

'宣言
 
Public Event BeforeRowFilterDropDownPopulate As BeforeRowFilterDropDownPopulateEventHandler

C#

public event BeforeRowFilterDropDownPopulateEventHandler BeforeRowFilterDropDownPopulate

イベント データ

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

プロパティ	解説
Column	クリックされた列ヘッダーフィルタードロップダウンボタンに関連付けられた列。
Handled	値リストに値が入力されているかどうかを示します。入力されている場合、UltraGrid は値リストに値を読み込みません。デフォルトは false です。
Rows	UltraGridOverride.RowFilterMode が SiblingRowsOnly に解決される場合は、クリックされたフィルター ドロップダウン ボタンを持つ列ヘッダーに関連付けられた行コレクションが渡されます。そうでなければ null になります。
ValueList	フィルター ドロップダウンとして使用する値リスト。この値リストにデータを入力してHandledをTrueに設定すると、UltraGridは値リストに値を読み込みません。

解説

BeforeRowFilterDropDownPopulate イベントを使用すると、フィルター値リストの設定を UltraGrid に任せるのではなく、開発者自身が値を設定できます。このイベントの後に発生する AfterRowFilterDropDownPopulate イベントでは、フィルター値リストの値はすでに設定されています。そこでもフィルター値リストを変更できます。

使用例

Visual Basic

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


    Private Sub UltraGrid1_BeforeRowFilterDropDownPopulate(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinGrid.BeforeRowFilterDropDownPopulateEventArgs) Handles UltraGrid1.BeforeRowFilterDropDownPopulate
        ' Set the Handled to prevent UltraGrid from populating the value list.
        e.Handled = True

        ' Populate the value list with custom filter values.
        e.ValueList.ValueListItems.Add("Test", "Test")
    End Sub

C#

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


		private void ultraGrid1_BeforeRowFilterDropDownPopulate(object sender, Infragistics.Win.UltraWinGrid.BeforeRowFilterDropDownPopulateEventArgs e)
		{
			// Set the Handled to prevent UltraGrid from populating the value list.
			e.Handled = true;

			// Populate the value list with custom filter values.
			e.ValueList.ValueListItems.Add( "Test", "Test" );
		}