FormatConditionCollection

FormatConditionCollection class

Представляет условное форматирование. FormatConditions может содержать до трех условных форматов.

public class FormatConditionCollection

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

ИмяОписание
Count { get; }Получает количество условий.
Item { get; }Получает условие форматирования по индексу.
RangeCount { get; }Получает количество условно отформатированных диапазонов.

Методы

ИмяОписание
Add(CellArea, FormatConditionType, OperatorType, string, string)Добавляет условие форматирования и диапазон ячеек в FormatConditions FormatConditions может содержать до трех условных форматов. В формулах условного форматирования не допускаются ссылки на другие листы.
AddArea(CellArea)Добавляет диапазон ячеек с условным форматированием.
AddCondition(FormatConditionType)Добавить условие формата.
AddCondition(FormatConditionType, OperatorType, string, string)Добавляет условие форматирования.
GetCellArea(int)Получает диапазон ячеек с условным форматированием по индексу.
RemoveArea(int)Удаляет диапазон ячеек условного форматирования по индексу.
RemoveArea(int, int, int, int)Удалить условное форматирование в диапазоне.
RemoveCondition(int)Удаляет условие форматирования по индексу.

Примеры


[C#]

//Создать новую книгу.
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");   

[Visual Basic]

'Создание экземпляра объекта 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")

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

FormatCondition FormatConditionType