FormatCondition

FormatCondition class

Представляет условие условного форматирования.

public class FormatCondition

Характеристики

Имя Описание
AboveAverage { get; } Получить экземпляр условного форматирования “AboveAverage”. Правило экземпляра по умолчанию выделяет ячейки, которые на выше среднего для всех значений в диапазоне. Допустимо только для типа = AboveAverage.
ColorScale { get; } Получить экземпляр “ColorScale” условного форматирования. Экземпляром по умолчанию является “зелено-желто-красный” 3ColorScale. Допустимо только для типа = ColorScale.
DataBar { get; } Получить экземпляр условного форматирования “DataBar”. Цвет экземпляра по умолчанию - синий. Допустим только для типа DataBar.
Formula1 { get; set; } Получает и задает значение или выражение, связанное с условным форматированием.
Formula2 { get; set; } Получает и задает значение или выражение, связанное с условным форматированием.
IconSet { get; } Получить экземпляр IconSet условного форматирования. IconSetType экземпляра по умолчанию — TrafficLights31. Допустимо только для type = IconSet.
Operator { get; set; } Получает и задает тип оператора условного формата.
Priority { get; set; } Приоритет этого правила условного форматирования. Это значение используется для определения того, какой формат должен оцениваться и отображаться. Меньшие числовые значения имеют более высокий приоритет, чем более высокие числовые значения, где «1» — наивысший приоритет.
StopIfTrue { get; set; } True, никакие правила с более низким приоритетом не могут быть применены к этому правилу, если это правило оценивается как true. Применяется только для Excel 2007;
Style { get; set; } Получает или устанавливает стиль диапазонов ячеек с условным форматированием.
Text { get; set; } Текстовое значение в правиле условного форматирования «текст содержит». Допустимо только для type = containsText, notContainsText, beginWith и EndsWith. Значение по умолчанию равно null.
TimePeriod { get; set; } Применимый период времени в правиле условного форматирования «дата появления…». Допустимо только для type = timePeriod. Значение по умолчанию — TimePeriodType.Today.
Top10 { get; } Получить экземпляр “Top10” условного форматирования. Правило экземпляра по умолчанию выделяет ячейки, значения которых попадают в верхние 10 квадратных скобок. Допустимо только для типа Top10.
Type { get; set; } Получает и устанавливает, является ли условный формат Type.

Методы

Имя Описание
GetFormula1(bool, bool) Получает значение или выражение, связанное с этим условием формата.
GetFormula1(int, int) Получает формулу условного форматирования ячейки.
GetFormula1(bool, bool, int, int) Получает значение или выражение условного форматирования ячейки.
GetFormula2(bool, bool) Получает значение или выражение, связанное с этим условием формата.
GetFormula2(int, int) Получает формулу условного форматирования ячейки.
GetFormula2(bool, bool, int, int) Получает значение или выражение условного форматирования ячейки.
SetFormula1(string, bool, bool) Задает значение или выражение, связанное с этим условием формата.
SetFormula2(string, bool, bool) Задает значение или выражение, связанное с этим условием формата.
SetFormulas(string, string, bool, bool) Задает значение или выражение, связанное с этим условием формата.

Примеры


[C#]
//Создание экземпляра объекта Workbook
Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];
 
//Добавляет пустое условное форматирование
int index = sheet.ConditionalFormattings.Add();
FormatConditionCollection fcs = sheet.ConditionalFormattings[index];
 
//Устанавливает диапазон условного формата.
CellArea ca = new CellArea();
ca.StartRow = 0;
ca.EndRow = 0;
ca.StartColumn = 0;
ca.EndColumn = 0;
fcs.AddArea(ca);
 
ca = new CellArea();
ca.StartRow = 1;
ca.EndRow = 1;
ca.StartColumn = 1;
ca.EndColumn = 1;
fcs.AddArea(ca);
 
//Добавляет условие.
int conditionIndex = fcs.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "=A2", "100");
 
//Добавляет условие.
int conditionIndex2 = fcs.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "50", "100");
 
//Устанавливаем цвет фона.
FormatCondition fc = fcs[conditionIndex];
fc.Style.BackgroundColor = Color.Red;
 
//Сохранение файла Excel
workbook.Save("output.xls");

[VB.NET]

'Создание экземпляра объекта Workbook
Dim workbook As Workbook = New Workbook()
Dim sheet As Worksheet = workbook.Worksheets(0)
 
' Добавляет пустое условное форматирование
Dim index As Integer = sheet.ConditionalFormattings.Add()
Dim fcs As FormatConditionCollection = sheet.ConditionalFormattings(index)
 
'Задает диапазон условного формата.
Dim ca As CellArea = New CellArea()
ca.StartRow = 0
ca.EndRow = 0
ca.StartColumn = 0
ca.EndColumn = 0
fcs.AddArea(ca)
ca = New CellArea()
ca.StartRow = 1
ca.EndRow = 1
ca.StartColumn = 1
ca.EndColumn = 1
fcs.AddArea(ca)
 
'Добавляет условие.
Dim conditionIndex As Integer = fcs.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "=A2", "100")
 
'Добавляет условие.
Dim conditionIndex2 As Integer = fcs.AddCondition(FormatConditionType.CellValue, OperatorType.Between, "50", "100")
 
'Устанавливает цвет фона.
Dim fc As FormatCondition = fcs(conditionIndex)
fc.Style.BackgroundColor = Color.Red
 
'Сохранение файла Excel
workbook.Save("output.xls")

Смотрите также