ТипОбластиОформления

Выделить собственную область старого построителя: Поле

ОбластьОформления относится к старому ПостроительОтчета, не к УсловноеОформлениеКомпоновкиДанных.

Подготовка

1. Модуль своей обычной формы обработки, толстый клиент. Основной блок — тело кнопки; две дополнительные функции / процедуры — отдельно в том же модуле. Все три товара создаются только в памяти.

2. Источник содержит Канцелярия: Книга 750, Ручка 50 и Упаковка: Коробка 60. Категория — настоящее измерение строки с таким же именем группировки; Сумма — числовое поле, у которого задан итог Сумма(Сумма).

3. Поле применяет оформление к выбранному полю Сумма, Группировка — к области указанной группировки Категория. Имена не заменены произвольными подписями ячеек.

Построитель = СобственныйПостроительТрехТоваров();
Построитель.ИзмеренияСтроки.Очистить();
Построитель.ИзмеренияСтроки.Добавить("Категория", "Категория");
Построитель.ИзмеренияКолонки.Очистить();
Построитель.ВыбранныеПоля.Очистить();
Построитель.ВыбранныеПоля.Добавить("Наименование");
Построитель.ВыбранныеПоля.Добавить("Сумма");
Построитель.ВыводитьДетальныеЗаписи = Истина;
Условия = Построитель.УсловноеОформление;
Условия.УстановитьДоступныеПоля(Построитель.ДоступныеПоля);
Правило = Условия.Добавить("СвояПодложка", "Выделить собственную область");
Правило.Использование = Истина;
Правило.Область.УстановитьДоступныеПоля(Построитель.ДоступныеПоля);
Правило.Область.Добавить("Сумма", "Своя область", ТипОбластиОформления.Поле);
ВыделитьСвоеПравилоЦветом(Правило);
Построитель.Выполнить();
Лист = Новый ТабличныйДокумент;
Построитель.Вывести(Лист);
Лист.Показать("Собственное оформление: Поле");
Сообщить("Применён тип области: Поле");

Функция СобственныйПостроительТрехТоваров()
    Данные = Новый ТаблицаЗначений;
    Данные.Колонки.Добавить("Категория", Новый ОписаниеТипов("Строка"));
    Данные.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
    Данные.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число"));
    Данные.Колонки.Добавить("Цена", Новый ОписаниеТипов("Число"));
    Данные.Колонки.Добавить("Сумма", Новый ОписаниеТипов("Число"));
    Образцы = Новый Массив;
    Образцы.Добавить(Новый Структура("Категория,Наименование,Количество,Цена", "Канцелярия", "Книга", 3, 250));
    Образцы.Добавить(Новый Структура("Категория,Наименование,Количество,Цена", "Канцелярия", "Ручка", 1, 50));
    Образцы.Добавить(Новый Структура("Категория,Наименование,Количество,Цена", "Упаковка", "Коробка", 2, 30));
    Для Каждого Образец Из Образцы Цикл
        СтрокаДанных = Данные.Добавить();
        ЗаполнитьЗначенияСвойств(СтрокаДанных, Образец);
        СтрокаДанных.Сумма = СтрокаДанных.Количество * СтрокаДанных.Цена;
    КонецЦикла;
    Описание = Новый ОписаниеИсточникаДанных(Данные);
    Для Каждого Колонка Из Описание.Колонки Цикл
        Колонка.Поле = Истина;
        Колонка.Отбор = Истина;
        Колонка.Порядок = Истина;
        Колонка.Измерение = Колонка.Имя = "Категория";
    КонецЦикла;
    Построитель = Новый ПостроительОтчета;
    Построитель.ИсточникДанных = Описание;
    Описание.Колонки.Сумма.Итог = "Сумма(Сумма)";
    Построитель.ЗаполнитьНастройки();
    Возврат Построитель;
КонецФункции

Процедура ВыделитьСвоеПравилоЦветом(Правило)
    Для Каждого Параметр Из Правило.Оформление Цикл
        Если Параметр.Имя = "ЦветФона" Тогда
            Параметр.Значение = Новый Цвет(255, 245, 180);
            Параметр.Использование = Истина;
            Прервать;
        КонецЕсли;
    КонецЦикла;
КонецПроцедуры

Разбор по шагам

1. Создайте собственный источник и группировку.

2. Добавьте собственное правило и тип области третьим аргументом Добавить.

3. Выполните настоящий вывод и сравните область подложки.

Как проверить результат

1. Правило без дополнительного отбора применяется ко всем соответствующим собственным областям. Подложка не меняет суммы товаров; общий исходный итог 860.

2. Имя / тип области и доступные поля относятся к реальному собственному построителю. BSL, печать и запись данных при сборке HTML не выполнялись.

Ожидаемый результат

Тип области реально участвует в собственном сформированном отчёте.

На что обратить внимание

1. Не переносите этот API на современный класс УсловноеОформлениеКомпоновкиДанных: у него другой контракт областей.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.