Условное форматирование в ZEXMLSS
ВНИМАНИЕ: условное форматирование пока поддерживается только для ODS!
Примеры кода
Наследован от TPersistent. Хранилище условных форматирований на листе.
Свойства:
Property
|
Краткое описание
|
Count: integer;
|
Количество условных форматирований
|
Items[Num: Integer]: TZConditionalStyle;
|
Возвращает условное форматирование под номером Num.
|
Методы:
Методы TZConditionalFormatting
|
Краткое описание
|
function function Add(): TZConditionalStyle; overload;
|
Добавляет новое условное форматирование. Увеличивает Count на 1.
|
function Add(Style: TZConditionalStyle): TZConditionalStyle; overload;
|
Добавляет новое условное форматирование путём копирования Style.
Увеличивает Count на 1.
|
function Add(ColumnNum, RowNum, AreaWidth, AreaHeight: integer): TZConditionalStyle; overload;
|
Добавляет новое условное форматирование. Устанавливает координаты, ширину и высоту области применения условного форматирования.
ColumnNum - номер столбца начала условного форматирования
RowNum - номер ряда
AreaWidth - ширина области с условным форматированием
AreaHeight - высота области с условным форматированием
Увеличивает Count на 1.
|
function Delete(num: integer): boolean;
|
Удаляет условное форматирование num.
Возвращает True при успешном удалении.
|
procedure Clear();
|
Удаляет все условные форматированияю
|
Наследован от TPersistent. Условное форматирование (стиль).
Свойства:
Property
|
Краткое описание
|
Areas: TZConditionalAreas;
|
Области листа для применения условного форматирования
|
Count: integer;
|
Количество стилей условного форматирования
|
Items[Num: Integer]: TZConditionalStyleItem;
|
Возвращает стиль условного форматирования под номером Num.
|
Методы:
Методы TZConditionalStyle
|
Краткое описание
|
function function Add(): TZConditionalStyleItem; overload;
|
Добавляет новый условие для условного форматирование. Увеличивает Count на 1.
|
function Add(StyleItem: TZConditionalStyleItem): TZConditionalStyleItem; overload;
|
Добавляет новое условие для условного форматирование путём копирования StyleItem.
Увеличивает Count на 1.
|
function Delete(num: integer): boolean;
|
Удаляет условие условное форматирование num.
Возвращает True при успешном удалении.
|
procedure Clear();
|
Удаляет все условия условного форматирования
|
Наследован от TPersistent. Условное форматирование.
Свойства:
Property
|
Краткое описание
|
ApplyStyleID: integer;
|
Номер применяемого стиля
|
BaseCellColumnIndex: integer;
|
Колонка базовой ячейки
|
BaseCellRowIndex: integer;
|
Ряд базовой ячейки
|
BaseCellPageIndex: integer;
|
Номер листа базовой ячейки. -1 - текущий лист.
По-умолчанию -1.
|
Condition: TZCondition;
|
Условие.
По-умолчанию ZCFCellContentOperator (значение ячейки оператор Value1).
|
ConditionOperator: TZConditionalOperator;
|
Оператор. Применяется только при Condition = ZCFCellContentOperator.
По-умолчанию ZCFOpEqual (значение ячейки = Value1).
|
Value1: String;
|
Значение1, с короторым сравнивается ячейка
|
Value2: String;
|
Значение2, с короторым сравнивается ячейка
|
Методы:
Методы TZConditionalStyleItem
|
Краткое описание
|
procedure Clear();
|
Устанавливает значения по-умолчанию:
- ApplyStyleID := -1;
- Condition := ZCFCellContentOperator;
- ConditionOperator := ZCFOpEqual;
- BaseCellPageIndex := -1;
- BaseCellRowIndex := 0;
- BaseCellColumnIndex := 0;
- Value1 := '';
- Value2 := '';
|
Наследован от TPersistent. Области для применения условного форматирования.
Свойства:
Property
|
Краткое описание
|
Count: integer;
|
Количество областей для применения условного форматирования.
|
Items[Num: Integer]: TZConditionalAreaItem;
|
Возвращает область под номером Num.
|
Методы:
Методы TZConditionalAreas
|
Краткое описание
|
function Add(): TZConditionalAreaItem; overload;
|
Добавляет новую область применения условного форматирования.
Увеличивает Count на 1.
|
function Add(ColumnNum, RowNum, AreaWidth, AreaHeight: integer): TZConditionalAreaItem; overload;
|
Добавляет новую область применения условного форматирования. Устанавливает координаты, ширину и высоту.
ColumnNum - номер столбца начала условного форматирования
RowNum - номер ряда
AreaWidth - ширина области с условным форматированием
AreaHeight - высота области с условным форматированием
Увеличивает Count на 1.
|
procedure Delete(num: integer);
|
Удаляет область num.
|
function IsCellInArea(ColumnNum, RowNum: integer): boolean;
|
Проверяет, попадает ли ячейка (ColumnNum, RowNum) в область. Возвращает True
в случае вхождения.
|
Наследован от TPersistent. Область для применения условного форматирования.
Свойства:
Property
|
Краткое описание
|
Row: integer;
|
Строка верхней левой ячейки области применения условного форматирования.
|
Column: integer;
|
Стобец верхней левой ячейки области применения условного форматирования.
|
Height: integer;
|
Высота области.
|
Width: integer;
|
Ширина области.
|
Типы:
Условия
TZCondition = (ZCFIsTrueFormula,
ZCFCellContentIsBetween,
ZCFCellContentIsNotBetween,
ZCFCellContentOperator,
ZCFNumberValue,
ZCFString,
ZCFBoolTrue,
ZCFBoolFalse,
ZCFFormula,
ZCFContainsText,
ZCFNotContainsText,
ZCFBeginsWithText,
ZCFEndsWithText,
ZCFCellIsEmpty,
ZCFDuplicate,
ZCFUnique,
ZCFAboveAverage,
ZCFBellowAverage,
ZCFAboveEqualAverage,
ZCFBelowEqualAverage,
ZCFTopElements,
ZCFBottomElements,
ZCFTopPercent,
ZCFBottomPercent,
ZCFIsError,
ZCFIsNoError);
Значение
|
Описание (условие срабатывает, если)
|
ZCFIsTrueFormula
|
Формула Value1 возвращает True.
Пример формулы: "ISODD(COLUMN())" - условное форматирование сработает на каждом не чётном столбце.
|
ZCFCellContentIsBetween
|
Значение ячейки находится между Value1 и Value2.
Ограничения:
- Тип ячейки должен быть ZENumber!
- Value1 и Value2 должны переводится в Float (разделитель "." или ",") или Int
|
ZCFCellContentIsNotBetween
|
Значение ячейки не между Value1 и Value2.
Ограничения:
- Тип ячейки должен быть ZENumber!
- Value1 и Value2 должны переводится в Float (разделитель "." или ",") или Int
|
ZCFCellContentOperator
|
Значение ячейки оператор (больше, меньше, равно ...) Value1
Ограничения:
- Тип ячейки должен быть ZENumber!
- Value1 должно переводится в Float (разделитель "." или ",") или Int
|
ZCFNumberValue
|
Не используется
|
ZCFString
|
Не используется
|
ZCFBoolTrue
|
Не используется
|
ZCFBoolFalse
|
Не используется
|
ZCFFormula
|
Не используется
|
ZCFContainsText
|
Значение ячейки содержит текст Value1.
|
ZCFNotContainsText
|
Значение ячейки не содержит текст Value1.
|
ZCFBeginsWithText
|
Значение ячейки начинается с Value1.
|
ZCFEndsWithText
|
Значение ячейки оканчивается на Value1.
|
ZCFCellIsEmpty
|
Ячейка пустая.
|
ZCFDuplicate
|
Дублирующиеся ячейки.
|
ZCFUnique
|
Уникальные значения ячеек.
|
ZCFAboveAverage
|
Значение ячейки больше среднего.
Тип ячейки должен быть ZENumber!
|
ZCFBellowAverage
|
Значение ячейки меньше среднего.
Тип ячейки должен быть ZENumber!
|
ZCFAboveEqualAverage
|
Значение ячейки больше либо равно среднему значению в области применения условного форматирования.
Тип ячейки должен быть ZENumber!
|
ZCFBelowEqualAverage
|
Значение ячейки меньше либо равно среднему значению в области применения условного форматирования.
Тип ячейки должен быть ZENumber!
|
ZCFTopElements
|
Первые Value1 элементов. (В LibreOffice Calc условие = "Первые 10 элементов")
Ограничения:
- Тип ячейки должен быть ZENumber!
- Value1 должно переводится Int
|
ZCFBottomElements
|
Последние Value1 элементов.
Ограничения:
- Тип ячейки должен быть ZENumber!
- Value1 должно переводится Int
|
ZCFTopPercent
|
Первые Value1 процентов.
Ограничения:
- Тип ячейки должен быть ZENumber!
- Value1 должно переводится Int или Float
|
ZCFBottomPercent
|
Последние Value1 процентов.
Ограничения:
- Тип ячейки должен быть ZENumber!
- Value1 должно переводится Int или Float
|
ZCFIsError
|
В ячейке ошибка.
|
ZCFIsNoError
|
В ячейке нет ошибки.
|
Операторы:
TZConditionalOperator = (ZCFOpGT,
ZCFOpLT,
ZCFOpGTE,
ZCFOpLTE,
ZCFOpEqual,
ZCFOpNotEqual);
Оператор
|
Описание
|
ZCFOpGT
|
> - Значение ячейки больше Value1.
|
ZCFOpLT
|
< - Значение ячейки меньше Value1.
|
ZCFOpGTE
|
>= - Значение ячейки больше или равно Value1.
|
ZCFOpLTE
|
<= - Значение ячейки меньше или равно Value1.
|
ZCFOpEqual
|
= - Значение ячейки равно Value1.
|
ZCFOpNotEqual
|
<> - Значение ячейки не равно Value1.
|
|