Добавляет элемент в заданную позицию.
Синтаксис
Вставить(<Индекс>, <Тип>)Полное описание, параметры и ограничения
КоллекцияВыбранныхПолейКомпоновкиДанных.Вставить (DataCompositionSelectedFieldCollection.Insert)
КоллекцияВыбранныхПолейКомпоновкиДанных (DataCompositionSelectedFieldCollection)
Вставить (Insert)
Доступен, начиная с версии 8.1.
Синтаксис:
Вставить(<Индекс>, <Тип>)
Параметры:
<Индекс> (обязательный)
Тип: Число.
Расположение элемента в коллекции.
<Тип> (обязательный)
Тип: Тип.
Тип добавляемого элемента. Элементами коллекции могут быть ВыбранноеПолеКомпоновкиДанных, ГруппаВыбранныхПолейКомпоновкиДанных, АвтоВыбранноеПолеКомпоновкиДанных.
Возвращаемое значение:
Тип: ВыбранноеПолеКомпоновкиДанных, ГруппаВыбранныхПолейКомпоновкиДанных, АвтоВыбранноеПолеКомпоновкиДанных.
Описание:
Добавляет элемент в заданную позицию.
Доступность:
Тонкий клиент, веб-клиент, сервер, толстый клиент, внешнее соединение.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Заменить и удалить колонки в коллекции выбора
Индексы коллекции начинаются с нуля; удаление из настроек не удаляет данные справочников.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Работайте в учебной базе на платформе 8.5.1.1343.
Фрагмент вставьте внутрь серверной процедуры учебной обработки; объекты конфигурации и внешние файлы не нужны.
Поставьте точку останова после создания настроек и посмотрите их дерево в отладчике.
Настройки = Новый НастройкиКомпоновкиДанных;
Выбор = Настройки.Выбор.Элементы;
ПервоеПоле = Выбор.Добавить(Тип("ВыбранноеПолеКомпоновкиДанных"));
ПервоеПоле.Поле = Новый ПолеКомпоновкиДанных("Наименование");
ПервоеПоле.Использование = Истина;
ВтороеПоле = Выбор.Вставить(0, Тип("ВыбранноеПолеКомпоновкиДанных"));
ВтороеПоле.Поле = Новый ПолеКомпоновкиДанных("Код");
ВтороеПоле.Использование = Истина;
Сообщить(Выбор.Получить(0).Поле);
Сообщить(Выбор.Индекс(ПервоеПоле));
Выбор.Удалить(ВтороеПоле);
Сообщить(Выбор.Количество());
Выбор.Очистить();
Сообщить(Выбор.Количество());Разбор по шагам
Добавить помещает поле в конец.
Вставить с индексом 0 ставит Код перед Наименование.
Получить и Индекс показывают новый порядок.
Удаляем конкретный элемент, затем очищаем только коллекцию выбранных полей.
Как проверить результат
Сообщения: Код; 1; 1; 0.
После Очистить дерево выбора пустое, сам объект Настройки существует.
Ожидаемый результат
Показаны вставка, чтение по индексу, поиск индекса, удаление элемента и очистка выбора.
На что обратить внимание
Данные базы этим кодом не изменяются; меняется только объект настроек в памяти.
Не путайте элементы коллекции выбора с элементами структуры отчёта.
Не вызывайте Получить(0) для пустой коллекции.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.