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()	Задает порядок оценки для этого правила условного форматирования, чтобы оно вычислялось после всех остальных правил на листе.

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

Share via