Infragistics logo
메뉴
.NET and JavaScript UI Controls
Version 24.2 (latest)

FilterEvaluationTrigger Enumeration

Used for specifying FieldSettings.FilterEvaluationTrigger property.
Syntax
public enum FilterEvaluationTrigger : System.Enum
Members
MemberDescription
DefaultDefault is resolved to OnCellValueChange.
OnCellValueChangeFilters are evaluated as soon as a filter cell’s value is changed. This will re-filter records as you type.
OnEnterKeyFilters are evaluated when you hit Enter key while on the filter record. Until you do so, any changes you make to the filter record will not get applied.
OnEnterKeyOrLeaveCellFilters are evaluated when you hit Enter key or leave the filter cell.
OnEnterKeyOrLeaveRecordFilters are evaluated when you hit Enter key or leave the filter record.
OnLeaveCellFilters are evaluated when you leave the filter cell.
OnLeaveRecordFilters are evaluated when you leave the filter record.
Example
The following code shows some of the properties and methods available to control the behavior regarding when filters are applied to records.

Imports Infragistics.Windows
Imports Infragistics.Windows.Controls
Imports Infragistics.Windows.Editors
Imports Infragistics.Windows.DataPresenter
Imports Infragistics.Windows.DataPresenter.Events

    Private Sub Window1_Loaded(ByVal sender As Object, ByVal e As RoutedEventArgs)
        
        ' FilterEvaluationTrigger controls when the filters are applied to records 
        ' when the user modifies the filter condition.
        _dp.FieldSettings.FilterEvaluationTrigger = FilterEvaluationTrigger.OnEnterKeyOrLeaveCell

        ' ReevaluateFiltersOnDataChange specifies whether to re-evaluate filters on
        ' a record whose data is changed. Default is true. If you set it to false,
        ' you can manually re-evaluate filters on all records using 
        ' RecordFilterCollection's Refresh method.
        _dp.FieldLayoutSettings.ReevaluateFiltersOnDataChange = False

    End Sub

    Private Sub Button1_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
        ' Typically calling this method is not necessary as the data presenter 
        ' re-evaluates filters on records whenever data changes. However if you 
        ' set the ReevaluateFiltersOnDataChange to false then you can use this 
        ' method to re-filter records.
        _dp.FieldLayouts(0).RecordFilters.Refresh()

        ' You can also re-evaluate filters on a specific data record by calling
        ' its RefreshFilters method.
        _dp.RecordManager.Sorted(0).RefreshFilters()
    End Sub
'Declaration
 
Public Enum FilterEvaluationTrigger 
   Inherits System.Enum
 
using Infragistics.Windows;
using Infragistics.Windows.Controls;
using Infragistics.Windows.Editors;
using Infragistics.Windows.DataPresenter;
using Infragistics.Windows.DataPresenter.Events;

		public void Window1_Loaded( object sender, RoutedEventArgs e )
		{
			// FilterEvaluationTrigger controls when the filters are applied to records 
			// when the user modifies the filter condition.
			_dp.FieldSettings.FilterEvaluationTrigger = FilterEvaluationTrigger.OnEnterKeyOrLeaveCell;

			// ReevaluateFiltersOnDataChange specifies whether to re-evaluate filters on
			// a record whose data is changed. Default is true. If you set it to false,
			// you can manually re-evaluate filters on all records using 
			// RecordFilterCollection's Refresh method.
			_dp.FieldLayoutSettings.ReevaluateFiltersOnDataChange = false;
		}

		private void Button1_Click( object sender, RoutedEventArgs e )
		{
			// Typically calling this method is not necessary as the data presenter 
			// re-evaluates filters on records whenever data changes. However if you 
			// set the ReevaluateFiltersOnDataChange to false then you can use this 
			// method to re-filter records.
			_dp.FieldLayouts[0].RecordFilters.Refresh( );

			// You can also re-evaluate filters on a specific data record by calling
			// its RefreshFilters method.
			_dp.RecordManager.Sorted[0].RefreshFilters( );
		}
'Declaration
 
Public Enum FilterEvaluationTrigger 
   Inherits System.Enum
 
Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also