Удаляет все элементы из коллекции.
Синтаксис
Очистить()Полное описание, параметры и ограничения
СерииДиаграммы.Очистить (ChartSeriesCollection.Clear)
СерииДиаграммы (ChartSeriesCollection)
Очистить (Clear)
Доступен, начиная с версии 8.3.14.
Синтаксис:
Очистить()
Описание:
Удаляет все элементы из коллекции.
Доступность:
Тонкий клиент, веб-клиент, сервер, толстый клиент, внешнее соединение.
Использование в версии:
Доступен, начиная с версии 8.3.14.
Методическая информация
Практические примеры
Добавить, вставить, сдвинуть и удалить учебные серии и точки
Ручная работа с коллекциями без источника данных. Удаляем только созданные здесь пустые дополнительные элементы.
Где и как запускать
Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.
Подготовка
В учебной базе создайте новую внешнюю обработку УчебнаяДиаграмма с пустой управляемой формой; назначьте форму основной.
Не создавайте реквизит График и поле ДиаграммаТоваров вручную: код создаёт их в ПриСозданииНаСервере.
В свойствах формы → События назначьте ПриСозданииНаСервере одноимённой процедуре. Сохраните EPF и откройте её в учебном тонком клиенте Windows.
Каждый урок использует отдельный модуль/копию формы. Данные вымышлены: план и факт в штуках за три месяца, не данные учёта.
&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
НовыеРеквизиты = Новый Массив;
НовыеРеквизиты.Добавить(Новый РеквизитФормы("График", Новый ОписаниеТипов("Диаграмма")));
ЭтаФорма.ИзменитьРеквизиты(НовыеРеквизиты);
Диаграмма = Новый Диаграмма;
Диаграмма.ТипДиаграммы = ТипДиаграммы.Гистограмма;
Серии = Диаграмма.Серии;
План = Серии.Добавить("План");
План.Значение = "plan";
Факт = Серии.Вставить(1, "Факт");
Факт.Значение = "actual";
ПустаяСерия = Серии.Добавить("Удалить эту пустую серию");
Сообщить(Серии.Количество() = 3);
Серии.Сдвинуть(Факт, -1);
Сообщить(Серии.Индекс(Факт) = 0);
Сообщить(Серии.Получить(0).Значение = "actual");
Серии.Удалить(Серии.Индекс(ПустаяСерия));
Сообщить(Серии.Количество() = 2);
Точки = Диаграмма.Точки;
Январь = Точки.Добавить("Январь");
Январь.Значение = "2026-01";
Февраль = Точки.Вставить(1, "Февраль");
Февраль.Значение = "2026-02";
ПустаяТочка = Точки.Добавить("Удалить эту пустую точку");
Точки.Сдвинуть(Февраль, -1);
Сообщить(Точки.Индекс(Февраль) = 0);
Сообщить(Точки.Получить(0).Значение = "2026-02");
Точки.Удалить(Точки.Индекс(ПустаяТочка));
Сообщить(Точки.Количество() = 2);
Диаграмма.УстановитьЗначение(Январь, План, 10);
Диаграмма.УстановитьЗначение(Январь, Факт, 8);
Диаграмма.УстановитьЗначение(Февраль, План, 12);
Диаграмма.УстановитьЗначение(Февраль, Факт, 11);
// Второй отдельный объект демонстрирует очистку своих коллекций.
Черновик = Новый Диаграмма;
Черновик.Серии.Добавить("Черновая серия");
Черновик.Точки.Добавить("Черновая точка");
Черновик.Серии.Очистить();
Черновик.Точки.Очистить();
Сообщить(Черновик.Серии.Количество() = 0);
Сообщить(Черновик.Точки.Количество() = 0);
Черновик.Очистить();
ЭтаФорма.График = Диаграмма;
Поле = Элементы.Добавить("ДиаграммаТоваров", Тип("ПолеФормы"));
Поле.Вид = ВидПоляФормы.ПолеДиаграммы;
Поле.ПутьКДанным = "График";
Поле.РастягиватьПоГоризонтали = Истина;
Поле.РастягиватьПоВертикали = Истина;
КонецПроцедуры
Разбор по шагам
У коллекций Серии и Точки есть собственные операции Добавить/Вставить. Их индексы начинаются с нуля.
После Сдвинуть(объект,-1) ищем новый индекс объекта, а не продолжаем использовать старый номер позиции.
Удаляем пустые дополнительные элементы по вычисленному индексу. Переменные удалённых объектов больше не читаем.
Заполняем четыре значения с помощью сохранившихся объектов, независимо от нового порядка.
Для Очистить создаём второй собственный Черновик; отображаемую диаграмму не очищаем.
Как проверить результат
На форме Февраль перед Январём, Факт перед Планом; значения остаются февраль 11/12 и январь 8/10.
После удаления пустых элементов две серии и две точки.
В отдельном черновике обе очищенные коллекции имеют размер 0; отображаемые значения не исчезли.
Ожидаемый результат
Коллекции изменены и проверены по идентичности объектов и новым индексам, а не по догадке о позиции.
На что обратить внимание
Не меняйте КоличествоСерий/КоличествоТочек при связи с источником данных.
Очистить удаляет данные диаграммы в памяти: здесь это только собственный ненужный черновик.
Ссылки на удалённую точку или серию недействительны даже если индекс позже занят новым элементом.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.