FilterEvaluationTrigger Property

Controls when the filters are evalulated whenever the user modifies filter criteria via filter cell. Default is resolved to OnCellValueChange which applies the filter as you type contents in the filter cell.

Syntax

Visual Basic

'Declaration
 
Public Property FilterEvaluationTrigger As FilterEvaluationTrigger

C#

public FilterEvaluationTrigger FilterEvaluationTrigger {get; set;}

Remarks

Controls when the filters are evalulated whenever the user modifies filter criteria. Default is resolved to OnCellValueChange which evaluates the filter as the user types contents in the filter cell.

This is only applicable to filter record ui (FilterUIType). To control if filters get re-evaluated on a data record if its data changes, use the property.

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