Тип: Строка. Содержит представление элемента отбора. Данное свойство недоступно у объектов, содержащихся в коллекции пользовательских настроек компоновки данных.
Полное описание, параметры и ограничения
ЭлементОтбораКомпоновкиДанных.Представление (DataCompositionFilterItem.Presentation)
ЭлементОтбораКомпоновкиДанных (DataCompositionFilterItem)
Представление (Presentation)
Доступен, начиная с версии 8.1.
Использование:
Чтение и запись.
Описание:
Тип: Строка.
Содержит представление элемента отбора.
Данное свойство недоступно у объектов, содержащихся в коллекции пользовательских настроек компоновки данных.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Подсветить малое количество в конкретной колонке учебной таблицы
При количестве меньше двух выделяем только колонку количества. Код создаёт таблицу и правило с нуля, данные не записывает.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В учебной базе: Файл → Новый → Внешняя обработка. Создайте управляемую форму и назначьте её основной. Дайте обработке имя УчебнаяТаблица.
Не добавляйте вручную реквизит Товары и одноимённые элементы: код создаст их при открытии. Модуль формы для этой задачи должен быть пустым.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Сохраните отдельную учебную EPF и откройте через Файл → Открыть.
Данные Книга/Ручка создаются в памяти формы. Справочники, документы и регистры вашей конфигурации не читаются и не записываются.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НовыеРеквизиты = Новый Массив;
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Товары", Новый ОписаниеТипов("ТаблицаЗначений")));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Код", Новый ОписаниеТипов("Строка"), "Товары", "Код"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Наименование", Новый ОписаниеТипов("Строка"), "Товары", "Название"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)), "Товары", "Количество"));
ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
Данные = Новый ТаблицаЗначений;
Данные.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)));
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "A-01";
СтрокаТовара.Наименование = "Книга";
СтрокаТовара.Количество = 3;
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "B-02";
СтрокаТовара.Наименование = "Ручка";
СтрокаТовара.Количество = 1;
ЭтаФорма.ЗначениеВРеквизитФормы(Данные, "Товары");
Таблица = ЭтаФорма.Элементы.Добавить("ТаблицаТоваров", Тип("ТаблицаФормы"));
Таблица.ПутьКДанным = "Товары";
Таблица.Заголовок = "Учебные товары";
Таблица.Шапка = Истина;
Таблица.АвтоВводНезаполненного = Ложь;
Таблица.АвтоВводНовойСтроки = Ложь;
Для Каждого ИмяКолонки Из СтрРазделить("Код,Наименование,Количество", ",") Цикл
Колонка = Элементы.Добавить("Товары" + ИмяКолонки, Тип("ПолеФормы"), Таблица);
Колонка.Вид = ВидПоляФормы.ПолеВвода;
Колонка.ПутьКДанным = "Товары." + ИмяКолонки;
Колонка.Заголовок = ИмяКолонки;
КонецЦикла;
Правило = ЭтаФорма.УсловноеОформление.Элементы.Добавить();
Правило.Использование = Истина;
Правило.Представление = "Учебное малое количество";
Правило.Оформление.УстановитьЗначениеПараметра("ЦветФона", Новый Цвет(255, 239, 200));
Правило.Оформление.УстановитьЗначениеПараметра("ЦветТекста", Новый Цвет(100, 60, 0));
Условие = Правило.Отбор.Элементы.Добавить(Тип("ЭлементОтбораКомпоновкиДанных"));
Условие.Использование = Истина;
Условие.ЛевоеЗначение = Новый ПолеКомпоновкиДанных("Товары.Количество");
Условие.ВидСравнения = ВидСравненияКомпоновкиДанных.Меньше;
Условие.ПравоеЗначение = 2;
Условие.Представление = "Количество меньше двух";
ПолеОформления = Правило.Поля.Элементы.Добавить();
ПолеОформления.Использование = Истина;
ПолеОформления.Поле = Новый ПолеКомпоновкиДанных("ТоварыКоличество");
Сообщить(ЭтаФорма.УсловноеОформление.ПолучитьКоличествоИспользуемых() = 1);
ПараметрЦвета = Новый ПараметрКомпоновкиДанных("ЦветФона");
ЗаданныйЦвет = Правило.Оформление.НайтиЗначениеПараметра(ПараметрЦвета);
Если ЗаданныйЦвет = Неопределено Тогда
ВызватьИсключение "Не найден установленный параметр цвета";
КонецЕсли;
Сообщить(ЗаданныйЦвет.Использование);
Сообщить(ТипЗнч(ЗаданныйЦвет.Значение) = Тип("Цвет"));
КонецПроцедуры
Разбор по шагам
Реквизит Товары хранит две строки, а поле ТоварыКоличество отображает числовую колонку.
Отбор сравнивает путь к данным Товары.Количество с числом 2.
Оформляемое поле указывается по имени элемента ТоварыКоличество, без точки. Это не тот же аргумент, что поле отбора.
УстановитьЗначениеПараметра задаёт фон/текст и включает использование соответствующего параметра.
НайтиЗначениеПараметра возвращает описание значения параметра, а не непосредственно Цвет; сначала проверяем Неопределено.
Форма применяет оформление при изменении данных; никакие обработчики записи документа не нужны.
Как проверить результат
При открытии количество Ручки 1 выделено, количество Книги 3 не выделено.
Измените количество Книги на 1: её числовая ячейка тоже должна выделиться.
Название и код не подкрашены этим правилом; проверки включённого параметра цвета Истина.
Ожидаемый результат
Создано правило визуальной подсветки данных с точной связью условие → поле → параметры оформления.
На что обратить внимание
Не передавайте Товары.Количество в список оформляемых полей формы вместо имени ТоварыКоличество.
Подсветка не фильтрует строки, не блокирует запись и не является проверкой бизнес-правил.
Пустой список оформляемых полей может расширить область действия: здесь поле указано явно.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Изменить список оформляемых колонок и восстановить точную область подсветки
На своём правиле управляем восьмью операциями списка полей. После эксперимента оформление снова касается только количества.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В учебной базе: Файл → Новый → Внешняя обработка. Создайте управляемую форму и назначьте её основной. Дайте обработке имя УчебнаяТаблица.
Не добавляйте вручную реквизит Товары и одноимённые элементы: код создаст их при открытии. Модуль формы для этой задачи должен быть пустым.
В свойствах формы → События свяжите ПриСозданииНаСервере с одноимённой процедурой. Сохраните отдельную учебную EPF и откройте через Файл → Открыть.
Данные Книга/Ручка создаются в памяти формы. Справочники, документы и регистры вашей конфигурации не читаются и не записываются.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НовыеРеквизиты = Новый Массив;
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Товары", Новый ОписаниеТипов("ТаблицаЗначений")));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Код", Новый ОписаниеТипов("Строка"), "Товары", "Код"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Наименование", Новый ОписаниеТипов("Строка"), "Товары", "Название"));
НовыеРеквизиты.Добавить(Новый РеквизитФормы("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)), "Товары", "Количество"));
ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
Данные = Новый ТаблицаЗначений;
Данные.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Наименование", Новый ОписаниеТипов("Строка"));
Данные.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число",
Новый КвалификаторыЧисла(9, 0, ДопустимыйЗнак.Неотрицательный)));
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "A-01";
СтрокаТовара.Наименование = "Книга";
СтрокаТовара.Количество = 3;
СтрокаТовара = Данные.Добавить();
СтрокаТовара.Код = "B-02";
СтрокаТовара.Наименование = "Ручка";
СтрокаТовара.Количество = 1;
ЭтаФорма.ЗначениеВРеквизитФормы(Данные, "Товары");
Таблица = ЭтаФорма.Элементы.Добавить("ТаблицаТоваров", Тип("ТаблицаФормы"));
Таблица.ПутьКДанным = "Товары";
Таблица.Заголовок = "Учебные товары";
Таблица.Шапка = Истина;
Таблица.АвтоВводНезаполненного = Ложь;
Таблица.АвтоВводНовойСтроки = Ложь;
Для Каждого ИмяКолонки Из СтрРазделить("Код,Наименование,Количество", ",") Цикл
Колонка = Элементы.Добавить("Товары" + ИмяКолонки, Тип("ПолеФормы"), Таблица);
Колонка.Вид = ВидПоляФормы.ПолеВвода;
Колонка.ПутьКДанным = "Товары." + ИмяКолонки;
Колонка.Заголовок = ИмяКолонки;
КонецЦикла;
Правило = ЭтаФорма.УсловноеОформление.Элементы.Добавить();
Правило.Использование = Истина;
Правило.Представление = "Учебное малое количество";
Правило.Оформление.УстановитьЗначениеПараметра("ЦветФона", Новый Цвет(255, 239, 200));
Правило.Оформление.УстановитьЗначениеПараметра("ЦветТекста", Новый Цвет(100, 60, 0));
Условие = Правило.Отбор.Элементы.Добавить(Тип("ЭлементОтбораКомпоновкиДанных"));
Условие.Использование = Истина;
Условие.ЛевоеЗначение = Новый ПолеКомпоновкиДанных("Товары.Количество");
Условие.ВидСравнения = ВидСравненияКомпоновкиДанных.Меньше;
Условие.ПравоеЗначение = 2;
Условие.Представление = "Количество меньше двух";
ПолеОформления = Правило.Поля.Элементы.Добавить();
ПолеОформления.Использование = Истина;
ПолеОформления.Поле = Новый ПолеКомпоновкиДанных("ТоварыКоличество");
Поля = Правило.Поля.Элементы;
Код = Поля.Добавить();
Код.Использование = Истина;
Код.Поле = Новый ПолеКомпоновкиДанных("ТоварыКод");
Название = Поля.Вставить(0);
Название.Использование = Истина;
Название.Поле = Новый ПолеКомпоновкиДанных("ТоварыНаименование");
Сообщить(Поля.Количество() = 3);
Сообщить(Поля.Индекс(Код) = 2);
Поля.Сдвинуть(Код, -2);
Сообщить(Поля.Индекс(Код) = 0);
Сообщить(Поля.Получить(0).Использование);
Поля.Удалить(Код);
Поля.Удалить(Название);
Сообщить(Поля.Количество() = 1);
// Пока форма ещё создаётся, заменяем только свой список оформляемых полей.
Поля.Очистить();
ПолеОформления = Поля.Добавить();
ПолеОформления.Использование = Истина;
ПолеОформления.Поле = Новый ПолеКомпоновкиДанных("ТоварыКоличество");
Сообщить(Поля.Количество() = 1);
КонецПроцедуры
Разбор по шагам
Поля правила — коллекция оформляемых элементов, не колонки исходной таблицы значений.
Добавляем Код, вставляем Название в начало и проверяем количество три.
Сдвинуть меняет порядок списка полей, а не порядок товаров или данных колонок.
Удаляем временные области оформления; количество снова остаётся единственным полем.
После Очистить сразу добавляем ТоварыКоличество. Это выполняется на создании формы, до возвращения её пользователю.
Порог отбора и значения двух товаров остаются неизменными.
Как проверить результат
Промежуточные проверки количества три/одно и индекса Код 2/0 Истина.
При открытии выделена только ячейка количества Ручки.
Код и название не выделяются, порядок товаров Книга/Ручка прежний.
Ожидаемый результат
Все восемь методов списка оформляемых полей разобраны без смешивания визуальной области с данными таблицы.
На что обратить внимание
Пустая область оформления может иметь более широкий смысл, поэтому после очистки поле восстанавливается сразу.
Не очищайте штатные правила рабочей формы: пример ограничен собственной учебной EPF.
Имена визуальных полей должны существовать в этой форме; здесь они созданы выше в том же коде.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.