RowFilterMode Enumeration

Dicates whether row filtering takes place at band level or rows collection level.

Syntax

Visual Basic

'Declaration
 
Public Enum RowFilterMode 
   Inherits System.Enum

C#

public enum RowFilterMode : System.Enum 

Members

Member	Description
AllRowsInBand	Row filtering will be done at the band level. ColumnFilters off the UltraGridBand will be used for filtering the rows and all the rows in the band associated with the override will be used. Also the contents of the filter drop-down will contain unique values from all the rows in the band.
Default	Default
SiblingRowsOnly	Row filtering will be done at the RowsCollection level. ColumnFilters off the RowsCollection will be used for filtering the rows in that RowsCollection (and not all the rows in the band). Also the contents of the filter drop-down will contain unique values from the rows in that rows collection. Note: When rows in a rows collection are grouped by columns, all the descendant groups will share the same column filters.

Example

Following code sets some of the properties related to row filtering functionality.

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
        ' Turn on row filtering functionality.
        e.Layout.Override.AllowRowFiltering = DefaultableBoolean.True

        ' Specifies whether to filter all rows in band or the sibling rows.
        e.Layout.Override.RowFilterMode = RowFilterMode.AllRowsInBand

        ' The action to take on rows that fail the filter criteria.
        e.Layout.Override.RowFilterAction = RowFilterAction.AppearancesOnly

        ' Setup various appearances that will be applied to rows that
        ' are filtered in (ones that pass the filter criteria).
        e.Layout.Override.FilteredInRowAppearance.BackColor = Color.Blue
        e.Layout.Override.FilteredInCellAppearance.ForeColor = Color.Yellow

        ' Setup various appearances that will be applied to rows that
        ' are filtered out (ones that fail the filter criteria).
        e.Layout.Override.FilteredOutRowAppearance.BackColor = SystemColors.ControlLight
        e.Layout.Override.FilteredOutCellAppearance.ForeColor = SystemColors.ControlDarkDark
    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)
		{
			// Turn on row filtering functionality.
			e.Layout.Override.AllowRowFiltering = DefaultableBoolean.True;

			// Specifies whether to filter all rows in band or the sibling rows.
			e.Layout.Override.RowFilterMode = RowFilterMode.AllRowsInBand;

			// The action to take on rows that fail the filter criteria.
			e.Layout.Override.RowFilterAction = RowFilterAction.AppearancesOnly;

			// Setup various appearances that will be applied to rows that
			// are filtered in (ones that pass the filter criteria).
			e.Layout.Override.FilteredInRowAppearance.BackColor = Color.Blue;
			e.Layout.Override.FilteredInCellAppearance.ForeColor = Color.Yellow;

			// Setup various appearances that will be applied to rows that
			// are filtered out (ones that fail the filter criteria).
			e.Layout.Override.FilteredOutRowAppearance.BackColor = SystemColors.ControlLight;
			e.Layout.Override.FilteredOutCellAppearance.ForeColor = SystemColors.ControlDarkDark;
		}

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