Содержит набор условных оформлений областей.
Полное описание, параметры и ограничения
УсловноеОформление (ConditionalAppearance)
УсловноеОформление (ConditionalAppearance)
Доступен, начиная с версии 8.0.
Элементы коллекции:
ЭлементУсловногоОформления
Для объекта доступен обход коллекции посредством оператора Для каждого … Из … Цикл. При обходе выбираются элементы условного оформления.
Возможно обращение к элементу оформления посредством оператора [...]. В качестве аргумента передается индекс (нумерация с 0).
Свойства:
<Имя элемента оформления> (<Format element name>)
Методы:
Вставить (Insert)
Добавить (Add)
Индекс (IndexOf)
Количество (Count)
Очистить (Clear)
Получить (Get)
ПолучитьДоступныеПоля (GetAvailableFields)
Сдвинуть (Move)
Удалить (Delete)
УстановитьДоступныеПоля (SetAvailableFields)
Конструкторы:
По умолчанию
Описание:
Содержит набор условных оформлений областей.
Доступность:
Сервер, толстый клиент, внешнее соединение.
Сериализуется.
См. также:
ПостроительОтчета, свойство УсловноеОформление
Использование в версии:
Доступен, начиная с версии 8.0.
Методическая информация
Практические примеры
Управлять редактированием: УсловноеОформление
В своей обычной форме получаем НастройкаУсловногоОформления из настоящего типизированного табличного поля. Меняем разрешения, не удаляя сами данные.
Где и как запускать
Полный модуль новой обычной формы учебной внешней обработки, толстый клиент 8.5.1.1343.
Подготовка
Отдельная собственная конфигурация УчебнаяКонфигурацияСинтаксиса, платформа 8.5.1.1343, толстый клиент с обычными формами. Не управляемая форма и не мобильный клиент.
Создайте отдельную учебную внешнюю обработку и её обычную основную форму. В реквизитах формы добавьте УчебныеДанные с типом УсловноеОформление; это реквизит формы, не реквизит документа.
В редакторе формы добавьте ТабличноеПоле с именем ТаблицаНастроек. Свойство Данные свяжите с УчебныеДанные. Расширение определяется типом этих данных, а не ручным созданием класса расширения.
Добавьте обычную кнопку УчебнаяКоманда, назначьте действие УчебнаяКоманда. Событие формы ПриОткрытии свяжите с процедурой ПриОткрытии. Вставьте полный модуль на уровне формы.
Откройте форму и до нажатия кнопки проверьте доступность Книга и Ручка. Нажатие учебной кнопки показывает операции коллекции разрешений и затем очищает только эти разрешения.
Правила доступности интерфейса не являются правами на данные, RLS или запретом программного изменения. Код не записывает базу, не читает рабочие каталоги и не меняет чужие формы.
Перем ИсходноеКоличество;
Процедура ПриОткрытии()
УчебныеДанные = Новый УсловноеОформление;
УчебныеДанные.Добавить("Книга", "Правило собственной книги");
УчебныеДанные.Добавить("Ручка", "Правило собственной ручки");
ИсходноеКоличество = 0;
Для Каждого СобственныйЭлемент Из УчебныеДанные Цикл
ИсходноеКоличество = ИсходноеКоличество + 1;
КонецЦикла;
Поле = ЭтаФорма.ЭлементыФормы.ТаблицаНастроек;
Управление = Поле.НастройкаУсловногоОформления;
Управление.Очистить();
Управление.Добавить("Книга", Ложь);
Управление.Добавить("Ручка", Истина);
Сообщить("До кнопки: Книга недоступно для интерактивного изменения, Ручка доступно");
КонецПроцедуры
Процедура УчебнаяКоманда(Кнопка)
Поле = ЭтаФорма.ЭлементыФормы.ТаблицаНастроек;
Управление = Поле.НастройкаУсловногоОформления;
Первое = Управление.Найти("Книга");
Второе = Управление.Найти("Ручка");
Если Первое = Неопределено Или Второе = Неопределено Тогда
ВызватьИсключение "Откройте свою форму заново: собственные разрешения уже очищены";
КонецЕсли;
Сообщить(Управление.Количество() = 2);
Сообщить(Первое.Имя = "Книга");
Сообщить(НЕ Первое.Доступность);
Сообщить(Второе.Доступность);
Сообщить(Управление.Индекс(Второе) = 1);
Сообщить(Управление.Получить(0) = Первое);
Сообщить(Управление.Найти("НетТакойУчебнойНастройки") = Неопределено);
Первое.Доступность = Истина;
Сообщить(Первое.Доступность);
Управление.Удалить(Второе);
Сообщить(Управление.Количество() = 1);
Управление.Очистить();
Сообщить(Управление.Количество() = 0);
ТекущееКоличество = 0;
Для Каждого СобственныйЭлемент Из УчебныеДанные Цикл
ТекущееКоличество = ТекущееКоличество + 1;
КонецЦикла;
Сообщить(ТекущееКоличество = ИсходноеКоличество);
Сообщить("Очистили только коллекцию разрешений, собственные исходные настройки сохранились");
КонецПроцедурыРазбор по шагам
Создать собственные данные нужного типа и связать их с обычным табличным полем через свойство Данные в редакторе формы.
Получить настоящий объект управления из расширения поля: у этого класса нет конструктора. Добавить своё запрещённое и разрешённое имя.
После ручной проверки интерфейса нажать кнопку. Найти свои элементы по именам, проверить позиции и включить доступность первого.
Удалить второй элемент разрешения, затем очистить только коллекцию разрешений. Сверить количество исходных настроек, а не принимать Очистить за удаление данных.
Повторный запуск требует заново открыть только свою форму: кнопка уже очистила созданные правила доступности.
Как проверить результат
Одиннадцать проверок коллекции разрешений и сохранения исходных настроек дают Истина.
До кнопки проверьте недоступность первого и доступность второго собственного элемента в реальном обычном поле. После кнопки ограничения очищены; исходные данные не удалены.
Ожидаемый результат
Полный подключённый к обычному редактору пример доступности с собственной типизированной формой и сохранением исходных настроек.
На что обратить внимание
Класс управления и класс исходных данных разные. У элемента управления Имя только читается, Доступность изменяется.
Свойство расширения поля только читается как ссылка на коллекцию. Не присваивайте Поле.НастройкаУсловногоОформления = Новый ... и не создавайте несуществующий конструктор.
Очистить разрешения не отключает существующий отбор и не удаляет исходные правила, области или параметры.
Статические проверки пособия подтверждают имена API и структуру кода, но не поведение конкретного редактора обычной формы: его проверяет пользователь в своей учебной базе.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Выделить суммы книги и коробки, не отбирая ручку из данных
Условное оформление старого построителя выделяет только ячейки Сумма >= 60. Отбор внутри правила влияет на оформление, а не на количество строк результата.
Где и как запускать
Полный модуль управляемой формы собственной учебной EPF: клиентский просмотр и серверное формирование отчёта.
Подготовка
Учебная внешняя обработка с пустой управляемой основной формой. Создайте команду УчебныйПример, кнопку команды и назначьте действие УчебныйПример.
Вставьте полный модуль урока: клиентский обработчик и серверную функцию. Каждый урок — отдельная копия модуля.
Откройте EPF в тонком клиенте Windows. Данные Книга/Ручка/Коробка создаются только в памяти; запрос урока с параметрами не читает таблицы базы.
ПостроительОтчета — существующий API для изучения/сопровождения старого кода. Это не СистемаКомпоновкиДанных и не рекомендация заменять ею современные отчёты.
Отдельная собственная конфигурация называется УчебнаяКонфигурацияСинтаксиса. Примеры создают только данные в памяти и собственный отчёт.
Используйте толстый клиент Windows 8.5.1.1343. УсловноеОформление в этих уроках относится к старому построителю, не к классу УсловноеОформлениеКомпоновкиДанных.
В исходных данных Книга: 3 × 250 = 750; Ручка: 1 × 50 = 50; Коробка: 2 × 30 = 60. Общий итог 860, Канцелярия 800, Упаковка 60.
&НаКлиенте
Процедура УчебныйПример(Команда)
ТабДок = СформироватьУчебныйОтчет();
ТабДок.ТолькоПросмотр = Истина;
ТабДок.Показать("Учебный ПостроительОтчета");
КонецПроцедуры
&НаСервере
Функция СформироватьУчебныйОтчет()
Данные = Новый ТаблицаЗначений;
Данные.Колонки.Добавить("Категория", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число"));
Данные.Колонки.Добавить("Цена", Новый ОписаниеТипов("Число"));
Данные.Колонки.Добавить("Сумма", Новый ОписаниеТипов("Число"));
Образцы = Новый Массив;
Образцы.Добавить(Новый Структура("Категория,Наименование,Количество,Цена", "Канцелярия", "Книга", 3, 250));
Образцы.Добавить(Новый Структура("Категория,Наименование,Количество,Цена", "Канцелярия", "Ручка", 1, 50));
Образцы.Добавить(Новый Структура("Категория,Наименование,Количество,Цена", "Упаковка", "Коробка", 2, 30));
Для Каждого Образец Из Образцы Цикл
СтрокаДанных = Данные.Добавить();
ЗаполнитьЗначенияСвойств(СтрокаДанных, Образец);
СтрокаДанных.Сумма = СтрокаДанных.Количество * СтрокаДанных.Цена;
КонецЦикла;
Описание = Новый ОписаниеИсточникаДанных(Данные);
Для Каждого Колонка Из Описание.Колонки Цикл
Колонка.Поле = Истина;
Колонка.Отбор = Истина;
Колонка.Порядок = Истина;
Колонка.Измерение = Колонка.Имя = "Категория";
КонецЦикла;
Построитель = Новый ПостроительОтчета;
Построитель.ИсточникДанных = Описание;
Построитель.АвтоДетальныеЗаписи = Ложь;
Построитель.ВыводитьДетальныеЗаписи = Истина;
Построитель.ВыводитьЗаголовокОтчета = Истина;
Построитель.ВыводитьОбщиеИтоги = Ложь;
Построитель.ВыводитьПодвалОтчета = Ложь;
Построитель.ВыводитьПодвалТаблицы = Ложь;
Построитель.ВыводитьШапкуТаблицы = Истина;
Построитель.ОтображатьСостояние = Ложь;
Построитель.ОбрабатыватьПрерываниеПользователя = Истина;
Построитель.ТекстЗаголовка = "Учебный отчёт — вымышленные данные";
Построитель.ЗаполнитьНастройки();
Построитель.ИзмеренияСтроки.Очистить();
Построитель.ИзмеренияКолонки.Очистить();
Построитель.ВыбранныеПоля.Очистить();
Построитель.ВыбранныеПоля.Добавить("Наименование", "Товар");
Построитель.ВыбранныеПоля.Добавить("Количество", "Количество");
Построитель.ВыбранныеПоля.Добавить("Сумма", "Сумма");
Условия = Построитель.УсловноеОформление;
Условия.УстановитьДоступныеПоля(Построитель.ДоступныеПоля);
ПроверкаПолей = Условия.ПолучитьДоступныеПоля();
Сообщить(ПроверкаПолей.Найти("Сумма") <> Неопределено);
Правило = Условия.Добавить("СобственнаяСумма", "Выделить стоимость от 60");
Правило.Имя = "СобственнаяСуммаОт60";
Правило.Заголовок = "Только собственные суммы от 60";
Правило.Использование = Истина;
Правило.Отбор.УстановитьДоступныеПоля(Построитель.ДоступныеПоля);
Порог = Правило.Отбор.Добавить("Сумма", "СобственныйПорог", "Стоимость");
Если Порог = Неопределено Тогда
ВызватьИсключение "Сумма не доступна для собственного правила";
КонецЕсли;
Порог.ВидСравнения = ВидСравнения.БольшеИлиРавно;
Порог.Установить(60, Истина);
Область = Правило.Область;
Область.УстановитьДоступныеПоля(Построитель.ДоступныеПоля);
ДоступныеОбласти = Область.ПолучитьДоступныеПоля();
Сообщить(ДоступныеОбласти.Найти("Сумма") <> Неопределено);
ПолеСуммы = Область.Добавить("Сумма", "Собственная стоимость", ТипОбластиОформления.Поле);
Сообщить(ПолеСуммы.Заголовок = "Собственная стоимость");
Сообщить(ПолеСуммы.ПутьКДанным = "Сумма");
ПолеСуммы.ТипОбласти = ТипОбластиОформления.Поле;
ПолеСуммы.ПутьКДанным = "Сумма";
Сообщить(Область.Количество() = 1);
ЦветУстановлен = Ложь;
Для Каждого Параметр Из Правило.Оформление Цикл
Если Параметр.Имя = "ЦветФона" Тогда
Сообщить(Параметр.ТипЗначения.СодержитТип(Тип("Цвет")));
Параметр.Значение = Новый Цвет(255, 245, 180);
Параметр.Использование = Истина;
Параметр.Заголовок = "Учебная подложка";
Сообщить(Параметр.Использование);
Сообщить(Параметр.Заголовок = "Учебная подложка");
Сообщить(ТипЗнч(Параметр.Значение) = Тип("Цвет"));
ЦветУстановлен = Истина;
КонецЕсли;
КонецЦикла;
Если НЕ ЦветУстановлен Тогда
ВызватьИсключение "Параметр ЦветФона не найден в собственной настройке оформления";
КонецЕсли;
Сообщить(Правило.Имя = "СобственнаяСуммаОт60");
Сообщить(Правило.Заголовок = "Только собственные суммы от 60");
Сообщить(Правило.Использование);
Построитель.Выполнить();
ПроверкаДанных = Построитель.Результат.Выгрузить();
Сообщить(ПроверкаДанных.Количество() = 3);
Сообщить(ПроверкаДанных.Итог("Сумма") = 860);
ТабДок = Новый ТабличныйДокумент;
Построитель.Вывести(ТабДок);
Возврат ТабДок;
КонецФункции
Разбор по шагам
Получить настоящую коллекцию УсловноеОформление своего построителя и передать ей допустимые поля источника.
Создать собственное правило с именем, заголовком и флагом использования. Его отбор: Сумма >= 60.
В область оформления добавить только поле Сумма, не группировку и не всю таблицу. Прочитать её заголовок и путь.
Обойти настоящую коллекцию параметров Оформление, найти ЦветФона по Имя, проверить допустимый тип Цвет и включить собственное значение.
Выполнить и показать отчёт. Проверить сохранение всех трёх строк и итога 860, затем визуально сверить подложку сумм 750 и 60.
Как проверить результат
Четырнадцать булевых проверок дают Истина при наличии стандартного параметра ЦветФона. Данных три строки, итог 860.
В отчёте жёлтая подложка у сумм 750 и 60, сумма 50 не выделяется. Ручка остаётся в отчёте. Визуальный результат отдельно проверяется в 1С.
Ожидаемый результат
Настоящее условное оформление работает над данными собственного отчёта и отделено от общего отбора строк.
На что обратить внимание
УсловноеОформление не равно УсловноеОформлениеКомпоновкиДанных: типы элементов, области и коллекции здесь другие.
Свойства Правило.Область, Отбор, Оформление только читаются как ссылки. Меняются полученные собственные объекты, не присваиваются новые коллекции.
Имя и ТипЗначения элемента настройки оформления только читаются. Для изменения вида задаются Значение и Использование.
Нет вывода о подложке по одной проверке цвета в параметре: нужен ручной просмотр самого отчёта.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.