Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Collapse]Spreadsheet
   [Expand]Product Information
    Product Structure
    Getting Started
   [Expand]Spreadsheet Document
    Supported Formats
   [Expand]Cell Basics
   [Expand]Spreadsheet Formulas
    Defined Names
    Data Binding
    Data Validation
   [Expand]Data Presentation
    Data Grouping
   [Expand]Pivot Table Overview
   [Expand]Charting Overview
    Printing
    Events
   [Expand]Mail Merge Overview
    Protection
    Find and Replace
   [Collapse]Visual Elements
     Workbook
     Worksheet
    [Expand]Cells and Cell Ranges
     Rows and Columns
     Formulas
     Name Box
     Pictures
    [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
      PivotTable Field List
      PivotTable Field Settings Dialog
      PivotTable Value Field Settings Dialog
      PivotTable Sort Dialog
      Insert Calculated Field Dialog
      Insert Calculated Item Dialog
      PivotTable Options Dialog
      PivotTable Solve Order Dialog
      New Formatting Rule Dialog
      Conditional Formatting Rules Manager
    Services
   [Expand]Shortcuts
   [Expand]Examples
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

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 Getting Started topic for a demonstration on how to provide a Ribbon UI for the SpreadsheetControl.

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 you 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.

Expanded See Also

How would you rate this topic?​​​​​​​