BeforeRowFilterChanged イベント

BeforeRowFilterChangedイベントは、ユーザーがいずれかの列の行フィルターを変更したときに発生します。このイベントはキャンセルできます。

シンタックス

Visual Basic

'宣言
 
Public Event BeforeRowFilterChanged As BeforeRowFilterChangedEventHandler

C#

public event BeforeRowFilterChangedEventHandler BeforeRowFilterChanged

イベント データ

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

プロパティ	解説
Cancel System.ComponentModel.CancelEventArgsから継承されます。
NewColumnFilter	変更された列フィルター条件。
ProcessMode	フィルターの処理モード。
Rows	列フィルターが適用される RowsCollection を返します。フィルターが子 RowsCollection に適用されており、RowFilterMode が AllRowsInBand の場合、このプロパティは null を返します。

使用例

Visual Basic

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



Private Sub ultraGrid1_BeforeRowFilterChanged(sender As Object, e As Infragistics.Win.UltraWinGrid.BeforeRowFilterChangedEventArgs)

   ' The ProcessMode property of the BeforeRowFilterChangedEventArgs event argument provides the ability
   ' to specify whether sorting and filtering of rows will occur synchronously or lazily.
   ' This can be usefull in situations where the grid contains a large number of records
   ' and the developer wishes to display a wait cursor during the sort or filter.  By default the grid applies
   ' sorting and filtering lazily to rows in each band as it is expanded.  If the ProccessMode property
   ' is set to either Synchronous or SynchronousExpanded the developer can ensure that either all rows
   ' in all bands, or all expanded rows in all bands are synchronously sorted and filtered, i.e., all at once.
   ' If a more fine grained approach is desired the RowsCollection overloaded EnsureSortedAndFiltered method can be used
   ' to specify how far down in the hierarchy of bands synchronous sorting and filtering should be applied.
   ' Setting the ProcessMode to Lazy specifies that the grid should apply sorting and filtering lazily
   ' to rows in each band as it is expanded.  This is the default behavior of the grid.
   e.ProcessMode = ProcessMode.Lazy
   
   ' Setting the ProcessMode to Synchronous specifies that the grid should apply sorting and filtering
   ' synchronously to all rows in all bands.
   e.ProcessMode = ProcessMode.Synchronous
   
   ' Setting the ProcessMode to SynchronousExpanded specifies that the grid should apply sorting and filtering
   ' synchronously to all expanded rows in all bands.
   e.ProcessMode = ProcessMode.SynchronousExpanded
   
   ' This code specifies that a wait cursor should be displayed when a user modifies a filter for a column
   ' and ensures that all rows in all bands are sorted while the wait cursor is displayed.
   ' The cursor should be reset in the grid's AfterRowFilterChanged event.
   e.ProcessMode = ProcessMode.Synchronous
   Me.ultraGrid1.Cursor = Cursors.WaitCursor

End Sub 'ultraGrid1_BeforeRowFilterChanged


Private Sub UltraGrid1_AfterRowFilterChanged(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinGrid.AfterRowFilterChangedEventArgs) Handles UltraGrid1.AfterRowFilterChanged
   
	' Reset the wait cursor
	Me.ultraGrid1.Cursor = Cursors.Default

   Debug.WriteLine("Rowfilters changed for column: " & e.Column.Key)

End Sub

C#

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

      private void ultraGrid1_BeforeRowFilterChanged(object sender, Infragistics.Win.UltraWinGrid.BeforeRowFilterChangedEventArgs e)
      {
          // The ProcessMode property of the BeforeRowFilterChangedEventArgs event argument provides the ability
          // to specify whether sorting and filtering of rows will occur synchronously or lazily.
          // This can be usefull in situations where the grid contains a large number of records
          // and the developer wishes to display a wait cursor during the sort or filter.  By default the grid applies
          // sorting and filtering lazily to rows in each band as it is expanded.  If the ProccessMode property
          // is set to either Synchronous or SynchronousExpanded the developer can ensure that either all rows
          // in all bands, or all expanded rows in all bands are synchronously sorted and filtered, i.e., all at once.
          // If a more fine grained approach is desired the RowsCollection overloaded EnsureSortedAndFiltered method can be used
          // to specify how far down in the hierarchy of bands synchronous sorting and filtering should be applied.

          // Setting the ProcessMode to Lazy specifies that the grid should apply sorting and filtering lazily
          // to rows in each band as it is expanded.  This is the default behavior of the grid.
          e.ProcessMode = ProcessMode.Lazy;

          // Setting the ProcessMode to Synchronous specifies that the grid should apply sorting and filtering
          // synchronously to all rows in all bands.
          e.ProcessMode = ProcessMode.Synchronous;

          // Setting the ProcessMode to SynchronousExpanded specifies that the grid should apply sorting and filtering
          // synchronously to all expanded rows in all bands.
          e.ProcessMode = ProcessMode.SynchronousExpanded;

          // This code specifies that a wait cursor should be displayed when a user modifies a filter for a column
          // and ensures that all rows in all bands are sorted while the wait cursor is displayed.
          // The cursor should be reset in the grid's AfterRowFilterChanged event.
          e.ProcessMode = ProcessMode.Synchronous;
          this.ultraGrid1.Cursor = Cursors.WaitCursor;
      }


		 private void ultraGrid1_AfterRowFilterChanged(object sender, Infragistics.Win.UltraWinGrid.AfterRowFilterChangedEventArgs e)
		 {
			  // Reset the wait cursor
			  this.ultraGrid1.Cursor = Cursors.Default;

			  Debug.WriteLine( "Rowfilters changed for column: " + e.Column.Key );
		 }