[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
   Reporting
  [Collapse]Data Grid
   [Expand]Getting Started
   [Expand]Implementation Details
   [Expand]Views
   [Expand]Grid View Data Layout
   [Expand]Binding to Data
   [Expand]Master-Detail Data Representation
   [Expand]Data Editing and Validation
   [Expand]Grouping
   [Expand]Selection
   [Expand]Filtering and Searching
   [Expand]Sorting
   [Expand]Data Summaries
   [Expand]Paging and Scrolling
   [Expand]Focus and Navigation
   [Collapse]Conditional Formatting
     Conditional Formats
     Creating Conditional Formatting Rules
     Conditional Formatting Menu
     Conditional Formatting Rules Manager
     Formatting Values Using Comparison Rules
     Formatting Date-Time Values
     Formatting Unique and Duplicate Values
     Formatting Top and Bottom Values
     Formatting Above or Below Average Values
     Formatting Changing Values
     Formatting Values Using Icon Sets
     Formatting Values Using Color Scales
     Formatting Values Using Data Bars
     Formatting Values Using Custom Conditions
     Formatting Focused Cells and Rows
     Examples
   [Expand]Drag-and-Drop
   [Expand]Appearance Customization
   [Expand]MVVM Enhancements
   [Expand]Printing and Exporting
   [Expand]End-User Interaction
   [Expand]Miscellaneous
   [Expand]Performance Improvement
   [Expand]Design-Time Features
   [Expand]Visual Elements
   [Expand]End-User Capabilities
   [Expand]Examples
  [Expand]Ribbon, Bars and Menu
  [Expand]Charts Suite
  [Expand]Pivot Grid
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Printing-Exporting
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Diagram Control
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Creating Conditional Formatting Rules

This topic describes how to create conditional formatting rules.

Expanded Creating Conditional Formatting Rules at Design Time

The GridControl provides the following ways of creating conditional formatting rules at design time:

Adding Rules Using Conditional Formatting Menu

The Conditional Formatting Menu allows you to quickly create conditional formatting rules using predefined settings.

In the design view, right-click a column to which you want to add a conditional formatting rule and select Conditional Formatting to invoke the conditional formatting menu.

Note

Specify the type of records contained in the data source using the DataControlBase.DesignTimeDataObjectType property to make the conditional formatting menu correctly work.

Adding Rules Using Conditional Formatting Rules Manager

The Conditional Formatting Rules Manager allows you to create conditional formatting rules with custom settings. You can view and edit all conditional formatting rules currently applied to the grid's view.

Use the following ways to invoke the conditional formatting rules manager:

  • In the design view, right-click a column and select Conditional Formatting | Manage Rules.

  • In the design view, right-click the GridControl's smart tag menu and select Manage Conditional Formatting Rules.

  • In the design view, right-click the GridColumn's smart tag menu and select Manage Conditional Formatting Rules.

Note

Specify the type of records contained in the data source using the DataControlBase.DesignTimeDataObjectType property to make the conditional formatting rules manager correctly work.

Expanded Creating Conditional Formatting Rules in Code

The TableView.FormatConditions (or TreeListView.FormatConditions) collection stores conditional formatting rules applied to the grid's view.

The following code sample illustrates how to define a conditional formatting rule in markup. See the How to: Apply Conditional Formatting example to learn more.

The code sample below illustrates how to define the same conditional formatting rule in code-behind. See the How to: Apply Conditional Formatting in Code-Behind example to learn more.

Use the following methods to remove conditional formatting rules:

Expanded Creating Conditional Formatting Rules at Runtime

The GridControl provides the following ways of creating conditional formatting rules at runtime:

Adding Rules Using Conditional Formatting Menu

The Conditional Formatting Menu allows you to quickly create conditional formatting rules using predefined settings.

Right-click a column to which you want to add a conditional formatting rule, and select Conditional Formatting in the displayed context menu to invoke the conditional formatting menu.

You can enable the conditional formatting menu as follows:

Adding Rules Using Conditional Formatting Rules Manager

The Conditional Formatting Rules Manager allows you to create conditional formatting rules with custom settings. You can view and edit all conditional formatting rules currently applied to the grid's view.

Click the Manage Rule item in the Conditional Formatting Menu to invoke the conditional formatting rules manager.

Set the TableView.AllowConditionalFormattingManager (or TreeListView.AllowConditionalFormattingManager) property to true to enable the manager at runtime.

Expanded See Also

Is this topic helpful?​​​​​​​