Удаляет элемент из коллекции.
Синтаксис
Удалить(<Элемент>)Полное описание, параметры и ограничения
МакетОформленияКомпоновкиДанных.Удалить (DataCompositionAppearanceTemplate.Delete)
МакетОформленияКомпоновкиДанных (DataCompositionAppearanceTemplate)
Удалить (Delete)
Доступен, начиная с версии 8.1.
Синтаксис:
Удалить(<Элемент>)
Параметры:
<Элемент> (обязательный)
Тип: ЗначениеПараметраКомпоновкиДанных, ЗначениеПараметраНастроекКомпоновкиДанных.
Удаляемый элемент.
Описание:
Удаляет элемент из коллекции.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Метод может быть вызван в том случае, если коллекция не связана с доступными параметрами. В противном случае генерируется исключение.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Составить небольшой макет оформления из двух параметров цвета
Собственная коллекция оформления содержит идентификатор параметра, значение цвета и флаг использования.
Где и как запускать
Полный серверный общий модуль собственной учебной базы; не клиентский модуль формы.
Подготовка
Собственная учебная база 8.5.1.1343. Создайте общий модуль УчебныеКоллекцииСКД с флагом Сервер. Вставьте полный текст одного урока с процедурой ВыполнитьПример() Экспорт.
Из серверной команды своей обработки вызовите УчебныеКоллекцииСКД.ВыполнитьПример(). Таблицы значений и служебные объекты макета остаются на сервере.
Книга / 3 / 750 и Ручка / 1 / 50 — вымышленные собственные данные. Ни справочники, ни документы, ни регистры базы, ни внешние сервисы не читаются.
Различайте схему, настройки, скомпилированный макет и результат. Урок составления отдельной коллекции не называется готовым рабочим отчётом.
В уроке описания расшифровки временное хранилище заполняется только новым собственным объектом, в одном вызове. В конце удаляется ровно этот созданный адрес, включая обработку ошибки.
Не заменяйте собственный новый макет текущим рабочим отчётом: Очистить, Удалить и Сдвинуть в этих уроках относятся к собственной памяти.
Процедура ВыполнитьПример() Экспорт
Оформление = Новый МакетОформленияКомпоновкиДанных;
Фон = Оформление.Добавить();
Фон.Параметр = Новый ПараметрКомпоновкиДанных("ЦветФона");
Фон.Значение = Новый Цвет(225, 245, 220);
Фон.Использование = Истина;
Текст = Оформление.Вставить(0);
Текст.Параметр = Новый ПараметрКомпоновкиДанных("ЦветТекста");
Текст.Значение = Новый Цвет(25, 70, 115);
Текст.Использование = Истина;
Сообщить(Оформление.Количество() = 2);
Сообщить(Оформление.Индекс(Текст) = 0);
Сообщить(Оформление.Получить(0) = Текст);
Сообщить(Оформление.Найти(Новый ПараметрКомпоновкиДанных("ЦветФона")) = Фон);
Сообщить(ТипЗнч(Фон.Значение) = Тип("Цвет"));
Сообщить(Фон.Использование);
Оформление.Удалить(Текст);
Сообщить(Оформление.Количество() = 1);
Сообщить(Оформление.Найти(Новый ПараметрКомпоновкиДанных("ЦветТекста")) = Неопределено);
Оформление.Очистить();
Сообщить(Оформление.Количество() = 0);
КонецПроцедурыРазбор по шагам
Создаём МакетОформленияКомпоновкиДанных, добавляем ЦветФона и вставляем ЦветТекста.
Параметр задаётся объектом ПараметрКомпоновкиДанных, Значение — собственным Цвет, Использование включено явно.
Ищем по новому объекту с тем же идентификатором ЦветФона, не по позиции и не по RGB.
Удаляем только текстовое оформление и проверяем отсутствие параметра, затем очищаем свой макет оформления.
Создание этой коллекции не окрашивает текущую форму автоматически; применение требует включения в соответствующий макет/вывод.
Как проверить результат
Девять булевых проверок Истина: два параметра, индекс, поиск, тип цвета, использование и очистка.
Рабочая форма и пользовательская тема остаются без изменений; код не обращается к ним.
Ожидаемый результат
Разобран отдельный макет оформления без выдачи настройки за уже отрисованный отчёт.
На что обратить внимание
Имя параметра ЦветФона не является русским произвольным заголовком или выражением BSL.
Не путайте МакетОформленияКомпоновкиДанных с Оформление элемента управляемой формы.
Вид итогового отчёта проверяется после настоящего вывода, не только по типу Цвет.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.