RangeInfo Class

Provides custom range boundaries and corresponding style settings used to apply conditional formatting to value ranges.

Namespace: DevExpress.DashboardCommon

Assembly: DevExpress.Dashboard.v21.2.Core.dll

Declaration

C#
VB.NET

public sealed class RangeInfo

Public NotInheritable Class RangeInfo

Remarks

Range conditions (FormatConditionRangeBase descendants) allow you to apply formatting using a predefined set of value ranges and corresponding style settings. You can use a predefined set of colors/icons to apply formatting or use custom ranges and corresponding icons/colors.

To use custom range boundaries and the required style specified for each range, do the following.

Specify whether an absolute or percent scale is used to define range boundaries using the FormatConditionRangeBase.ValueType property.
Create the required number of RangeInfo objects that are the ranges containing boundary values (the RangeInfo.Value property), a comparison logic (RangeInfo.ValueComparison) and style setting applied to range values (RangeInfo.StyleSettings).
Add initialized RangeInfo objects to the FormatConditionRangeBase.RangeSet collection.
Assign the resulting FormatConditionRangeBase descendant to the DashboardItemFormatRule.Condition property.

The following code snippets (auto-collected from DevExpress Examples) contain references to the RangeInfo class.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#
VB.NET

how-to-apply-conditional-formatting-to-grid-cells-in-win-dashboard/CS/Dashboard_ConditionalFormatting_Grid/IconRangeConditionForm.cs#L36

FormatConditionRangeSet rangeCondition = (FormatConditionRangeSet)rangeRule.Condition;
RangeInfo range3 = rangeCondition.RangeSet[2];
range3.Value = 50;

how-to-apply-conditional-formatting-to-grid-cells-using-the-icon-ranges-format-condition-t259991/CS/Dashboard_ConditionalFormatting_Grid/Form1.cs#L37

FormatConditionRangeSet rangeCondition = (FormatConditionRangeSet)rangeRule.Condition;
RangeInfo range3 = rangeCondition.RangeSet[2];
range3.Value = 50;

how-to-apply-conditional-formatting-to-grid-cells-using-the-gradient-ranges-condition-t260005/CS/Dashboard_ConditionalFormatting_Grid/Form1.cs#L42

                        new AppearanceSettings(Color.PaleGreen), 9);
RangeInfo middleRange = rangeCondition.RangeSet[4];
middleRange.StyleSettings = new AppearanceSettings(Color.SkyBlue);

how-to-apply-conditional-formatting-to-grid-cells-in-win-dashboard/VB/Dashboard_ConditionalFormatting_Grid/IconRangeConditionForm.vb#L35

Dim rangeCondition As FormatConditionRangeSet = CType(rangeRule.Condition, FormatConditionRangeSet)
Dim range3 As RangeInfo = rangeCondition.RangeSet(2)
range3.Value = 50

how-to-apply-conditional-formatting-to-grid-cells-using-the-icon-ranges-format-condition-t259991/VB/Dashboard_ConditionalFormatting_Grid/Form1.vb#L33

Dim rangeCondition As FormatConditionRangeSet = CType(rangeRule.Condition, FormatConditionRangeSet)
Dim range3 As RangeInfo = rangeCondition.RangeSet(2)
range3.Value = 50

how-to-apply-conditional-formatting-to-grid-cells-using-the-gradient-ranges-condition-t260005/VB/Dashboard_ConditionalFormatting_Grid/Form1.vb#L36

rangeCondition.Generate(New AppearanceSettings(Color.PaleVioletRed), New AppearanceSettings(Color.PaleGreen), 9)
Dim middleRange As RangeInfo = rangeCondition.RangeSet(4)
middleRange.StyleSettings = New AppearanceSettings(Color.SkyBlue)

Inheritance

Object

RangeInfo

.NET Subscription

Common Tools

Controls

Tools

Controls and Extensions

Tools

Maintenance Mode

.NET Subscription

Common Tools

Controls

Tools

Controls and Extensions

Tools

Maintenance Mode

RangeInfo Class

Declaration

Remarks

Inheritance

RangeInfo Class

Declaration

Remarks

Related GitHub Examples

Inheritance