The requested page is not available for the requested platform. You are viewing the content for Default platform.

Gradient Ranges

  • 4 min to read

Gradient Ranges allow you to use predefined color gradients to apply conditional formatting to different ranges of values. You can also use specific colors to generate custom gradients. These format rules can be applied to measures or numeric dimensions.

Create a Format Rule in the WinForms Designer

To format values according the required condition, click the measure menu button, select Add Format Rule | Gradient Ranges and choose the required color gradient.

GradientRanges_Menu

This invokes the Gradient Ranges dialog containing the set of value ranges and corresponding appearance settings. The Grid dashboard item on the right displays the default formatting applied using the predefined Red-Blue gradient.

GradientRangeDialog

This dialog allows you to change the following options specific to Gradient Ranges.

  • Number of ranges allows you to specify the number of ranges used to classify values. Click the Generate Ranges button to generate a new gradient scale according to the specified number of ranges.
  • The Use % ranges check box specifies whether the percent or absolute scale is used to generate ranges.

    Note

    Note that this option is not available for date-time dimensions.

  • To change the specific color in the gradient, click the button next to the required color and select a new color or specify a custom background color. This allows you to create a color gradient based on more than two colors. In this case, the specified colors are marked with an empty square.

    GradientRangeDialog_ChangeColor

    To learn how to specify a custom color, see the Specify Appearance Settings paragraph in the Conditional Formatting topic.

  • You can change range boundaries by specifying the required values.

    GradientRangeDialog_ChangeRangeStop

    Note

    Note that a new value should fall into a range between corresponding values of the previous and next range.

  • To change the comparison logic for the required range, click the comparison sign and select the required option.

    GradientRangeDialog_ChangeComparisonLogic

    The greater or equal sign includes the smallest value in the current interval while the greater sigh excludes the smallest value from the current interval and includes it in the next interval.

Create a Format Rule in the Web Dashboard

In the Conditional Formatting section, click the plus button to add a new format rule:

Select the data item you want to format and set the condition type to Range Gradient:

Select the required color set:

This action opens the Range Gradient settings where you can configure a format rule and specify its style.

Create a Format Rule in Code

Range gradient conditions allow you to apply formatting using value ranges and a specified color gradient. You can specify whether an absolute or percent scale is used to define range boundaries using the FormatConditionRangeBase.ValueType property. You can use the following approaches to apply formatting using range gradient conditions.

  1. To use a predefined set of start/end colors to create a color gradient, pass the required FormatConditionRangeGradientPredefinedType enumeration value to the FormatConditionRangeGradient constructor or to the corresponding FormatConditionRangeGradient.Generate method overload.
  2. To use custom colors and a specified number of ranges to create a color gradient, pass the required start/end colors (by initializing the AppearanceSettings object) and number of ranges to the FormatConditionRangeGradient constructor or to the corresponding FormatConditionRangeGradient.Generate method overload.
  3. To use custom colors and specified range boundaries to create a color gradient, pass the required start/end colors (by initializing the AppearanceSettings object) and an array of boundary values to the FormatConditionRangeGradient constructor or to the corresponding FormatConditionRangeGradient.Generate method overload. You can also specify boundary values by calling the FormatConditionRangeBase.SetValues method.
  4. To use custom range boundaries and the required style specified for each range, do the following.

Assign the resulting FormatConditionRangeGradient object to the DashboardItemFormatRule.Condition property.

How to: Apply Conditional Formatting to Grid Cells using the Gradient Ranges Format Condition