[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].NET Core 3 Support
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
   Reporting
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Expand]Charts Suite
  [Expand]Pivot Grid
  [Expand]Scheduler
  [Collapse]Spreadsheet
    Product Structure
   [Expand]Getting Started
   [Expand]Spreadsheet Document
    Supported Formats
   [Expand]Cell Basics
   [Expand]Formulas
    Defined Names
    Data Binding
    Data Validation
   [Expand]Data Presentation
   [Expand]Pivot Table Overview
   [Expand]Charts and Graphics
    Printing
    Events
    Protection
    Operation Restrictions
    Find and Replace
   [Expand]Mail Merge
   [Collapse]Visual Elements
    [Collapse]Dialogs
      Format Cells Dialog
      Paste Special Dialog
      Edit Hyperlink Dialog
      Symbol Dialog
      Create Table Dialog
      Change Chart Type Dialog
      Find and Replace Dialog
      Encrypt Document Dialog
      Password Dialog
      Protect Workbook Dialog
      Protect Sheet Dialog
      User Permissions Dialog
      Insert Function Dialog
      Function Arguments Dialog
      Name Manager
      New Name Dialog
      Create Names from Selection Dialog
      Subtotal Dialog
      Data Validation Dialog
      Properties Dialog
      Page Setup Dialog
      Header and Footer Dialog
      Create PivotTable Dialog
      Move PivotTable Dialog
      Change PivotTable Data Source Dialog
      PivotTable Field List
      PivotTable Value Field Settings Dialog
      PivotTable Field Settings Dialog
      PivotTable Sort Dialog
      Insert Calculated Field Dialog
      Insert Calculated Item Dialog
      PivotTable Solve Order Dialog
      PivotTable Options Dialog
      New Formatting Rule Dialog
      Conditional Formatting Rules Manager
     Pop-up Menus
    Services
    Themes and Templates
   [Expand]Shortcuts
   [Expand]Examples
  [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]Gantt 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]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Conditional Formatting Rules Manager

The Conditional Formatting Rules Manager lists all conditional formatting rules contained in a specific document area and allows end-users to create new rules, as well as edit and remove the existing ones.

You can invoke the dialog by clicking the Manage Rules… item in the Conditional Formatting drop-down menu. Add the Styles ribbon page group to the SpreadsheetControl to enable this menu. See the Lesson 1 - Create a Simple Spreadsheet topic for an example on how to provide a ribbon UI for the spreadsheet application.

The dialog shows the following information on each conditional formatting rule:

Dialog Column

Description

API

Rule (applied in order shown)

Shows the formatting rule description.

AverageConditionalFormatting

ExpressionConditionalFormatting

RangeConditionalFormatting

RankConditionalFormatting

SpecialConditionalFormatting

TextConditionalFormatting

TimePeriodConditionalFormatting

DataBarConditionalFormatting

ColorScale2ConditionalFormatting

ColorScale3ConditionalFormatting

IconSetConditionalFormatting

Format

Shows the resulting appearance of the cell that meets the rule criterion.

ISupportsFormatting.Formatting

Applies to

Displays the cell range to which the conditional formatting is applied. End-users can change the cell range by typing the cell reference in the corresponding dialog cell or selecting it directly in the worksheet.

ConditionalFormatting.Range

Stop if True

A check box indicating whether rules lower in precedence are applied if the current rule condition is true. Note that this option is unavailable for the rules that format cells using data bars, color scale or icon sets.

ConditionalFormatting.StopIfTrue

The formatting rules are shown in order of precedence (the priority is determined by the ConditionalFormatting.Priority property). A new formatting rule is automatically added to the top of the list and has the highest precedence. End-users can change the precedence of a desired formatting rule in the list using the Up and Down buttons.

The Show formatting rules for list allows end-users to select the part of the document (current selection, worksheet, pivot table, table, etc. ) whose formatting rules should be displayed.

Clicking the New Rule... button invokes the New Formatting Rule dialog which allows end-users to specify a new formatting rule's settings.

Clicking the Edit Rule... button allows an end-user to modify an existing formatting rule using the Edit Formatting Rule dialog.

An end-user can click the Delete Rule button or press Delete key to remove the selected formatting rule.

Tip

To create the conditional formatting rules using the Spreadsheet API, use the corresponding methods of the ConditionalFormattingCollection collection. For more information, refer to the examples in the Conditional Formatting section.

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