Previous topicNext topic
Help > 开发指南 > Excel > API > 示例 > 条件格式 >
如何：使用双色刻度设置单元格格式

此示例演示如何应用双色刻度条件格式规则。

  1. 首先，使用 ConditionalFormattingCollection.CreateValue 方法指定范围的最小和最大阈值，该方法创建 ConditionalFormattingValue 对象的实例。此对象提供对阈值及其类型的访问。阈值的类型由 ConditionalFormattingValueType 枚举值之一确定，可以是数字、百分比、公式或百分位数。使用 ConditionalFormattingValueType.MinMax 参数调用 ConditionalFormattingCollection.CreateValue 方法，以将最小和最大阈值分别设置为单元格区域中的最低值和最高值。
  2. 若要应用由 ColorScale2ConditionalFormatting 对象表示的条件格式设置规则，请从 Worksheet.ConditionalFormattings 属性访问条件格式的集合，并使用以下参数调用 ConditionalFormattingCollection.AddColorScale2ConditionalFormatting 方法：

注意

条件格式不支持透明度。

若要删除 ColorScale2ConditionalFormatting 对象，请使用 ConditionalFormattingCollection.Remove、ConditionalFormattingCollection.RemoveAt 或 ConditionalFormattingCollection.Clear 方法。

Vb.Net
Dim conditionalFormattings As DevExpress.Spreadsheet.ConditionalFormattingCollection = worksheet.ConditionalFormattings
'将最小阈值设置为单元格范围内的最低值。
Dim minPoint As DevExpress.Spreadsheet.ConditionalFormattingValue = conditionalFormattings.CreateValue(DevExpress.Spreadsheet.ConditionalFormattingValueType.MinMax)
'将最大阈值设置为单元格范围内的最高值。
Dim maxPoint As DevExpress.Spreadsheet.ConditionalFormattingValue = conditionalFormattings.CreateValue(DevExpress.Spreadsheet.ConditionalFormattingValueType.MinMax)
'创建双色比例规则，以区分单元格C2到D15中的低值和高值。蓝色表示较低的值，黄色表示较高的值。
Dim cfRule As DevExpress.Spreadsheet.ColorScale2ConditionalFormatting = conditionalFormattings.AddColorScale2ConditionalFormatting(worksheet.Range("$C$2:$D$15"), minPoint, Color.FromArgb(255, &H9D, &HE9, &HFA), maxPoint, Color.FromArgb(255, &HFF, &HF6, &HA9))

C#
DevExpress.Spreadsheet.ConditionalFormattingCollection conditionalFormattings = worksheet.ConditionalFormattings;
// 将最小阈值设置为单元格范围内的最低值。
DevExpress.Spreadsheet.ConditionalFormattingValue minPoint = conditionalFormattings.CreateValue(DevExpress.Spreadsheet.ConditionalFormattingValueType.MinMax);
// 将最大阈值设置为单元格范围内的最高值。
DevExpress.Spreadsheet.ConditionalFormattingValue maxPoint = conditionalFormattings.CreateValue(DevExpress.Spreadsheet.ConditionalFormattingValueType.MinMax);
// 创建双色比例规则，以区分单元格C2到D15中的低值和高值。蓝色表示较低的值，黄色表示较高的值。
DevExpress.Spreadsheet.ColorScale2ConditionalFormatting cfRule = conditionalFormattings.AddColorScale2ConditionalFormatting(worksheet.Range["$C$2:$D$15"], minPoint, Color.FromArgb(255, 0x9D, 0xE9, 0xFA), maxPoint, Color.FromArgb(255, 0xFF, 0xF6, 0xA9));

下图显示了结果（工作簿在 Microsoft® Excel® 中打开）。成本分布使用两种颜色的渐变显示。蓝色表示较低的值，黄色表示较高的值。