MeetsCriteria(ColumnFilter) Method

Returns true if the row meets the criteria specified by the passed in column filter which contains the collection of filter conditions.

Syntax

Visual Basic

'Declaration
 
Public Overloads Function MeetsCriteria( _
   ByVal columnFilter As ColumnFilter _
) As Boolean

C#

public bool MeetsCriteria( 
   ColumnFilter columnFilter
)

Parameters

columnFilter

An instance of ColumnFilter containing information on the criteria.

Return Value

true if the row meets the criteria of the FilterCondition, false if it does not.

Remarks

Returns true if the row meets the criteria specified by the passed in column filter.

Example

Following sample code shows a typical usage for MeetsCriteria method. It will filter out rows so that only the rows whose CustomerID field begins with either the letter 'A' or the letter 'B' will be displayed. It uses the overload of MeetsCriteria that takes in a ColumnFilter object. A ColumnFilter object can contian multiple filter conditions that are Or'ed or And'ed depending on the value of the filterLogicalOperator parameter (the second parameter) to the constructor.

Visual Basic

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


    Private Sub UltraGrid1_InitializeLayout(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinGrid.InitializeLayoutEventArgs) Handles UltraGrid1.InitializeLayout
        ' Call RefreshFilters to cause the UltraGrid to reevaluate any filters and fire
        ' FilterRow event on every row.
        '
        e.Layout.RefreshFilters()
    End Sub

    Private Sub UltraGrid1_FilterRow(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinGrid.FilterRowEventArgs) Handles UltraGrid1.FilterRow
        Dim band As UltraGridBand = e.Row.Band
        If "Customers" = band.Key Then
            ' Construct a ColumnFilter object. Note that we are specifying logical operator of "OR" as 
            ' the second parameter to the constructor. That's because we want to show rows that begin
            ' with 'A' OR 'B'.
            '
            Dim cf As ColumnFilter = New ColumnFilter(band.Columns("CustomerID"), FilterLogicalOperator.Or)
            cf.FilterConditions.Add(FilterComparisionOperator.Like, "A*")
            cf.FilterConditions.Add(FilterComparisionOperator.Like, "B*")

            ' Call MeetsCriteria off the row to test if the row passes the column filter.
            '
            If Not e.Row.MeetsCriteria(cf) Then
                e.RowFilteredOut = True
            Else
                e.RowFilteredOut = False
            End If
        End If
    End Sub

C#

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


		private void ultraGrid1_InitializeLayout(object sender, Infragistics.Win.UltraWinGrid.InitializeLayoutEventArgs e)
		{
			// Call RefreshFilters to cause the UltraGrid to reevaluate any filters and fire
			// FilterRow event on every row.
			//
			e.Layout.RefreshFilters( );
		}

		private void ultraGrid1_FilterRow(object sender, Infragistics.Win.UltraWinGrid.FilterRowEventArgs e)
		{
			UltraGridBand band = e.Row.Band;
			if ( "Customers" == band.Key )
			{
				// Construct a ColumnFilter object. Note that we are specifying logical operator of "OR" as 
				// the second parameter to the constructor. That's because we want to show rows that begin
				// with 'A' OR 'B'.
				//
				ColumnFilter cf = new ColumnFilter( band.Columns[ "CustomerID" ], FilterLogicalOperator.Or );
				cf.FilterConditions.Add( FilterComparisionOperator.Like, "A*" );
				cf.FilterConditions.Add( FilterComparisionOperator.Like, "B*" );

				// Call MeetsCriteria off the row to test if the row passes the column filter.
				//
				if ( ! e.Row.MeetsCriteria( cf ) )
					e.RowFilteredOut = true;
				else
					e.RowFilteredOut = false;
			}
		}

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, 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