将三色刻度格式应用于列

Goto Appearance and Conditional Formatting 外观和条件格式

将三色刻度格式应用于列

此示例说明了如何在设计时使用 Grid Designer 和代码将三色刻度格式应用于 GridControl 中的 Unit Price 列。

三色刻度格式使用三种颜色的渐变来反映列单元格值的数据分布。在此示例中，使用了 Green - White - Red 色标。值较低的单元格将具有较绿色，中等值的单元格将具有白色，较高的单元格值将具有较多的红色。

要在设计时创建新的格式规则，请从网格设计器中调用格式规则集合编辑器。还可以通过单击 ColumnView.FormatRules 属性的省略号按钮，从 Properties 网格中访问它。

调用 Grid Designer 并切换到 Style Format Rules 页面（在 Appearance 类别中）。

单击 Add 按钮 GridDesignerAddButton 以创建新的格式规则（GridControl 中的格式规则由 GridFormatRule 对象封装）。

选择 Format using 3 color scales 规则类型。格式规则的 FormatRuleBase.Rule 属性将设置为新的 FormatConditionRule3ColorScale 对象。

将 GridFormatRule.Column 属性设置为 Unit Price 列。此列提供要根据格式设置规则进行测试的值。

默认情况下，该格式将应用于同一列。但是，您可以通过设置 GridFormatRule.ColumnApplyTo 属性将此格式应用于其他列。此外，您还可以通过将 GridFormatRule.ApplyToRow 属性设置为 true 来将格式应用于整行。

使用 FormatConditionRule2ColorScale.PredefinedName 属性选择一个预定义的色阶。您可以在 Properties 选项卡或 Rule 选项卡。的 Rule 选项卡还允许您查看所选色阶的预览。在此示例中，选择了 Green - White - Red 色阶。

您还可以使用 FormatConditionRule2ColorScale.MinimumColor、FormatConditionRule3ColorScale.MiddleColor 和 FormatConditionRule2ColorScale.MaximumColor 属性提供自定义色阶。

默认情况下，FormatConditionRuleMinMaxBase.MinimumType、FormatConditionRule3ColorScale.MiddleType 和 FormatConditionRuleMinMaxBase.MaximumType 属性设置为 Automatic。这意味着应用格式的最小值、最大值和中点值是自动计算的。还可以使用 FormatConditionRuleMinMaxBase.Minimum、FormatConditionRule3ColorScale.Middle 和 FormatConditionRuleMinMaxBase.Maximum 属性（MinimumType/MiddleType/MaximumType 属性应设置为“数字”或“百分比”）指定要视为最小值、中点和最大值的值。

运行应用程序。下图说明了结果。

以下代码等效于上面显示的设计时操作。

/*
 * 将三色刻度格式应用于列
 */
GridFormatRule gridFormatRule3 = new GridFormatRule();
FormatConditionRule3ColorScale formatConditionRule3ColorScale = new FormatConditionRule3ColorScale();
gridFormatRule3.Column = gridView1.Columns["charge_total"]; ;
formatConditionRule3ColorScale.PredefinedName = "Green, White, Red";
gridFormatRule3.Rule = formatConditionRule3ColorScale;
gridView1.FormatRules.Add(gridFormatRule3);