Conditional Formatting Rules Manager

  • 2 minutes to read

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.

DXSpreadsheet_Dialogs_ConditionalFormattingRulesManager

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.

DXSpreadsheet_Dialogs_ConditionalFormattingRulesManager_Command

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.

DXSpreadsheet_Dialogs_ConditionalFormattingRulesManager_ShowFor

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

DXSpreadsheet_Dialogs_ConditionalFormattingRulesManager_NewRule

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

DXSpreadsheet_Dialogs_ConditionalFormattingRulesManager_EditRule

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.