ДанныеФормыКоллекцияЭлементовДерева.Индекс

Вставить, переместить и удалить товары только в учебном дереве формы

На собственной категории демонстрируем все восемь методов коллекции детей. Итоговые Книга и Ручка сохраняются; временные узлы удаляются.

Подготовка

1. В учебной базе создайте новую внешнюю обработку УчебноеДерево с пустой управляемой основной формой. Каждую задачу размещайте в отдельной копии формы.

2. Не создавайте вручную реквизит Категории и элементы ДеревоКатегорий: код создаёт их программно.

3. В свойствах формы → События назначьте ПриСозданииНаСервере одноимённой процедуре из кода. Остальные процедуры вставьте полностью на уровне модуля.

4. Сохраните собственную EPF и откройте в 1С через Файл → Открыть. Данные Книга/Ручка создаются только в памяти формы.

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    Новые = Новый Массив;
    Новые.Добавить(Новый РеквизитФормы("Категории", Новый ОписаниеТипов("ДеревоЗначений")));
    Новые.Добавить(Новый РеквизитФормы("Название", Новый ОписаниеТипов("Строка"), "Категории"));
    Новые.Добавить(Новый РеквизитФормы("Количество", Новый ОписаниеТипов("Число"), "Категории"));
    ЭтаФорма.ИзменитьРеквизиты(Новые);
    Дерево = Новый ДеревоЗначений;
    Дерево.Колонки.Добавить("Название", Новый ОписаниеТипов("Строка"));
    Дерево.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число"));
    Группа = Дерево.Строки.Добавить();
    Группа.Название = "Канцелярия";
    Книга = Группа.Строки.Добавить();
    Книга.Название = "Книга";
    Книга.Количество = 3;
    Ручка = Группа.Строки.Добавить();
    Ручка.Название = "Ручка";
    Ручка.Количество = 1;
    Резерв = Дерево.Строки.Добавить();
    Резерв.Название = "Резерв";

    ЭтаФорма.ЗначениеВРеквизитФормы(Дерево, "Категории");
    Таблица = Элементы.Добавить("ДеревоКатегорий", Тип("ТаблицаФормы"));
    Таблица.ПутьКДанным = "Категории";
    Таблица.Отображение = ОтображениеТаблицы.Дерево;
    Таблица.Заголовок = "Учебные категории — данные только в памяти";
    Таблица.АвтоВводНовойСтроки = Ложь;
    Таблица.АвтоВводНезаполненного = Ложь;
    Для Каждого ИмяКолонки Из СтрРазделить("Название,Количество", ",") Цикл
        Поле = Элементы.Добавить("Категории" + ИмяКолонки, Тип("ПолеФормы"), Таблица);
        Поле.Вид = ВидПоляФормы.ПолеВвода;
        Поле.ПутьКДанным = "Категории." + ИмяКолонки;
        Поле.Заголовок = ИмяКолонки;
    КонецЦикла;

    КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
    КомандаДействия.Действие = "УчебноеДействие";
    КомандаДействия.Заголовок = "Проверить операции над детьми";
    КомандаДействия.Подсказка = "Действие только над данными учебной формы";
    КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
    Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
    Кнопка.ИмяКоманды = КомандаДействия.Имя;
    Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры

&НаКлиенте
Процедура УчебноеДействие(Команда)
    Корни = Категории.ПолучитьЭлементы();
    Группа = Корни.Получить(0);
    Дети = Группа.ПолучитьЭлементы();
    Карандаш = Дети.Вставить(1);
    Карандаш.Название = "Карандаш";
    Карандаш.Количество = 2;
    Сообщить(Дети.Количество() = 3);
    Сообщить(Дети.Индекс(Карандаш) = 1);
    Дети.Сдвинуть(1, 1);
    Сообщить(Дети.Индекс(Карандаш) = 2);
    Сообщить(Дети.Получить(2).Название = "Карандаш");
    Дети.Удалить(2);
    Временный = Дети.Добавить();
    Временный.Название = "Временная строка";
    Временный.Количество = 99;
    Дети.Удалить(Временный);
    Резерв = Корни.Получить(1);
    РезервныеДети = Резерв.ПолучитьЭлементы();
    Черновик = РезервныеДети.Добавить();
    Черновик.Название = "Черновик только этой формы";
    РезервныеДети.Очистить();
    Сообщить(РезервныеДети.Количество() = 0);
    Сообщить(Дети.Количество() = 2);
    Сообщить(Дети.Получить(0).Название = "Книга");
    Сообщить(Дети.Получить(1).Название = "Ручка");
    Сообщить(Корни.Количество() = 2);
КонецПроцедуры

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

1. Вставить(1) помещает Карандаш между Книгой и Ручкой. Индексы начинаются с нуля и относятся только к одной коллекции детей.

2. Сдвинуть(1, 1) перемещает строку на одну позицию к концу; объект строки сохраняется, его индекс меняется.

3. Получить читает строку по позиции. Удалить поддерживает позицию и сам элемент: в уроке использованы оба варианта.

4. Добавить помещает временную строку в конец; удаление не записывает изменения в справочник.

5. Очистить вызывается только для собственных детей Резерва. Канцелярия и сами корневые группы не очищаются.

6. После удаления не обращаемся к Карандашу и Временному: эти элементы больше не принадлежат коллекции.

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

1. Карандаш сначала имеет индекс 1, после сдвига 2.

2. После кнопки в Канцелярии снова только Книга 3 и Ручка 1; Резерв пустой.

3. Повторное нажатие даёт тот же итог: временные узлы не накапливаются.

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

Все восемь операций коллекции детей проверены на собственной структуре без удаления рабочих данных.

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

1. Очистить удаляет всех детей выбранной коллекции, поэтому нельзя переносить вызов на рабочий объект без проверки области действия.

2. Позиция 1 в корнях и позиция 1 у Канцелярии относятся к разным строкам.

3. Перемещение по позиции внутри коллекции не переносит строку к другому родителю.

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