Поделиться через

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 объектом коллекции. Правило форматирования цветовой шкалы можно создать с помощью Add(XlFormatConditionType, Object, Object, Object, Object, Object, Object, Object) метода или AddColorScale(Int32) коллекции FormatConditions .

Цветовые шкалы — это визуальные руководства, помогающие понять распределение и вариации данных. К диапазону данных, данных в таблице или в отчете сводной таблицы можно применить двухцветную или трехцветную шкалу. Для условного формата двухцветной шкалы необходимо назначить значение, тип и цвет минимальным и максимальным пороговым значениям диапазона. Трехцветная шкала также имеет пороговое значение в середине.

Каждое из этих пороговых значений определяется путем задания свойств ColorScaleCriteria объекта . Объект ColorScaleCriteria , являющийся дочерним для объекта ColorScale , представляет собой коллекцию ColorScaleCriterion всех объектов для цветовой шкалы.

Свойства

Application

При использовании без квалификатора объектов это свойство возвращает _Application объект, представляющий приложение Microsoft Office Excel. При использовании с квалификатором объектов это свойство возвращает объект Application , представляющий создателя указанного объекта. Только для чтения.
AppliesTo

Возвращает объект, Range указывающий диапазон ячеек, к которому применяется правило форматирования.
ColorScaleCriteria

ColorScaleCriteria Возвращает объект , представляющий собой коллекцию отдельных ColorScaleCriterion объектов. Объект ColorScaleCriterion задает тип, значение и цвет пороговых критериев, используемых в условном формате цветовой шкалы. Только для чтения.
Creator

Возвращает константу в перечислении XlCreator , указывающую приложение, в котором был создан этот объект. Только для чтения.
Formula

Возвращает или задает строку, представляющую формулу, которая определяет значения, к которым будет применен набор значков.
Parent

Возвращает родительский объект для указанного объекта. Только для чтения.
Priority

Возвращает или задает значение приоритета правила условного форматирования. Приоритет определяет порядок вычисления, если на листе существует несколько правил условного форматирования.
PTCondition

Возвращает логическое значение, указывающее, применяется ли условный формат к диаграмме PivotTable . Только для чтения.
ScopeType

Возвращает или задает одну из констант XlPivotConditionScope перечисления, которая определяет область условного формата при его применении к диаграмме сводной таблицы.
StopIfTrue

Возвращает или задает логическое значение, которое определяет, следует ли оценивать дополнительные правила форматирования в ячейке, если текущее правило имеет значение True.
Type

Возвращает одну из констант перечисления XlFormatConditionType , указывающую тип условного формата. Только для чтения.

Методы

Delete()

Удаляет указанный объект правила условного форматирования.
ModifyAppliesToRange(Range)

Задает диапазон ячеек, к которому применяется это правило форматирования.
SetFirstPriority()

Задает для этого правила условного форматирования значение "1", чтобы оно было оценено перед всеми другими правилами на листе.
SetLastPriority()

Задает порядок оценки для этого правила условного форматирования, чтобы оно вычислялось после всех остальных правил на листе.

Применяется к