FilterEvaluationTrigger Enumeration

Used for specifying FieldSettings.FilterEvaluationTrigger property.

Syntax

Visual Basic

'Declaration
 
Public Enum FilterEvaluationTrigger 
   Inherits System.Enum

C#

public enum FilterEvaluationTrigger : System.Enum 

Members

Member	Description
Default	Default is resolved to OnCellValueChange.
OnCellValueChange	Filters are evaluated as soon as a filter cell’s value is changed. This will re-filter records as you type.
OnEnterKey	Filters 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.
OnEnterKeyOrLeaveCell	Filters are evaluated when you hit Enter key or leave the filter cell.
OnEnterKeyOrLeaveRecord	Filters are evaluated when you hit Enter key or leave the filter record.
OnLeaveCell	Filters are evaluated when you leave the filter cell.
OnLeaveRecord	Filters 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.

Visual Basic

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

C#

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( );
		}

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