ColorScale 接口

定义

命名空间:

Microsoft.Office.Interop.Excel

程序集:

Microsoft.Office.Interop.Excel.dll

代表色阶条件格式规则。

public interface class ColorScale

[System.Runtime.InteropServices.Guid("00024493-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface ColorScale

Public Interface ColorScale

属性

GuidAttribute InterfaceTypeAttribute

示例

以下代码示例创建了一个数字范围，然后将双色色阶条件格式规则应用于该范围。 然后指定最小阈值的颜色为红色，最大阈值的颜色为蓝色。

<span class="label">Sub CreateColorScaleCF() 































































































































































































































































    Dim cfColorScale As </span>
<i>ColorScale</i>
<span class="label">'Fill cells with sample data from 1 to 10     With ActiveSheet         .Range("C1") = 1         .Range("C2") = 2         .Range("C1:C2").AutoFill Destination:=Range("C1:C10")     End With          Range("C1:C10").Select          'Create a two-color ColorScale object for the created sample data range     Set cfColorScale = Selection.FormatConditions.AddColorScale(ColorScaleType:=2)          'Set the minimum threshold to red and maximum threshold to blue     cfColorScale.ColorScaleCriteria(1).FormatColor.Color = RGB(255, 0, 0)     cfColorScale.ColorScaleCriteria(2).FormatColor.Color = RGB(0, 0, 255)          End Sub</span>

注解

所有条件格式对象都包含在 FormatConditions 集合对象中，集合对象是集合的子对象 Range 。 可以使用 FormatConditions 集合的 或 AddColorScale(Int32) 方法创建色阶格式规则Add(XlFormatConditionType, Object, Object, Object, Object, Object, Object, Object)。

色阶是直观的参照，可以帮助您了解数据的分布和变化。 您可以对数据范围、表中的数据或数据透视表中的数据应用双色或三色色阶。 对于双色色阶条件格式，您可以将值、类型和颜色分配给范围的最小和最大阈值。 三色色阶还具有中点阈值。

每个阈值都是通过设置 对象的属性确定的 ColorScaleCriteria 。 ColorScaleCriteria 对象是 ColorScale 对象的子级，是色阶的所有ColorScaleCriterion对象的集合。

属性

Application	在没有对象限定符的情况下使用时，此属性返回一个 _Application 表示 Microsoft Office Excel 应用程序的 对象。 如果与对象识别符一起使用，则此属性返回代表指定对象的创建者的 Application 对象。 此为只读属性。
AppliesTo	返回一个 Range 对象，该对象指定应用格式规则的单元格区域。
ColorScaleCriteria	返回一个 ColorScaleCriteria 对象，该对象是单个 ColorScaleCriterion 对象的集合。 对象 ColorScaleCriterion 指定色阶条件格式中使用的阈值条件的类型、值和颜色。 此为只读属性。
Creator	在枚举中 XlCreator 返回一个常量，该常量指示创建此对象的应用程序。 此为只读属性。
Formula	返回或设置一个代表公式（该公式确定将对图标集应用的值）的 String。
Parent	返回指定对象的父对象。 只读。
Priority	返回或设置条件格式规则的优先级值。 当工作表中存在多个条件格式规则时，优先级确定求值的顺序。
PTCondition	返回一个 布尔 值，该值指示条件格式是否正在应用于 PivotTable 图表。 此为只读属性。
ScopeType	返回或设置枚举的常量之一，该常量 XlPivotConditionScope 确定条件格式应用于数据透视表时的范围。
StopIfTrue	返回或设置一个 Boolean 值，该值确定在当前规则的计算结果为 True 时是否应计算单元格上的其他格式规则。
Type	返回枚举的常量之一，该常量 XlFormatConditionType 指定条件格式的类型。 此为只读属性。

方法

Delete()	删除指定的条件格式规则对象。
ModifyAppliesToRange(Range)	设置此格式规则所应用于的单元格区域。
SetFirstPriority()	将此条件格式规则的优先级值设置为“1”，以便在工作表上的所有其他规则之前计算此规则。
SetLastPriority()	为此条件格式规则设置求值顺序，以便在工作表上的所有其他规则之后计算此规则。