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