将数据条格式应用于列

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

将数据条格式应用于列

此示例说明了如何在设计时和在代码中将数据条格式应用于 GridControl 中的 Unit Price 列。

数据条根据相对于其他单元格的单元格值按比例填充列单元格。较长的条形对应较高的值，较短的条形对应较低的值。

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

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

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

选择 Format using Data bar 规则类型。格式规则的 FormatRuleBase.Rule 属性将设置为新的 FormatConditionRuleDataBar 对象。

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

默认情况下，该格式将应用于 Unit Price 列。但是，您可以通过设置 GridFormatRule.ColumnApplyTo 属性将此格式应用于其他列。

使用 FormatConditionRuleDataBar.PredefinedName 属性选择一种预定义的条形样式。您可以在 Properties 选项卡或 Rule 选项卡。此外，Rule 选项卡还允许您查看所选样式的预览。在此示例中，选择了 Blue Data Bar Gradient 样式。

您还可以使用 FormatConditionRuleDataBar.Appearance 和 FormatConditionRuleDataBar.AppearanceNegative 属性提供自定义条形样式。

默认情况下，FormatConditionRuleMinMaxBase.MinimumType 和 FormatConditionRuleMinMaxBase.MaximumType 属性设置为 Automatic。这意味着将自动计算应用格式的最小值和最大值。还可以使用 FormatConditionRuleMinMaxBase.Minimum 和 FormatConditionRuleMinMaxBase.Maximum 属性（MinimumType/MaximumType 属性应设置为 Number 或 Percent）指定要被视为最小值和最大值的值。

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

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

/*
 * 将数据条格式应用于列
 */
GridFormatRule gridFormatRule = new GridFormatRule();
FormatConditionRuleDataBar formatConditionRuleDataBar = new FormatConditionRuleDataBar();
gridFormatRule.Column = gridView1.Columns["charge_total"];
formatConditionRuleDataBar.PredefinedName = "Blue Gradient";
gridFormatRule.Rule = formatConditionRuleDataBar;
this.gridView1.FormatRules.Add(gridFormatRule);