Вставляет новый элемент в список значений на позицию с указанным индексом.
Синтаксис
Метод Вставить()
имеет следующий синтаксис:
ЭлементСпискаЗначений Вставить(Индекс, [Значение=], [Представление=""], [Пометка=Ложь], [Картинка=])
А также альтернативный англоязычный синтаксис:
ValueListElement Insert(Index, [Value=], [Title=""], [Marker=false], [Picture=])
Параметры
Описание параметров метода Вставить()
:
Имя параметра* | Тип | Описание |
---|---|---|
Индекс | Число | Индекс позиции, на которую надо вставить элемент. |
Значение | Произвольный | Значение, которое необходимо вставить. |
Представление | Строка
ФорматированнаяСтрока |
Строковое выражение, содержащее представление добавляемого значения. Значение по умолчанию: Пустая строка |
Пометка | Булево | Пометка элемента списка значений. Значение по умолчанию: Ложь |
Картинка | Картинка | Визуальное представление значения. Значение по умолчанию: Пустая картинка |
*Жирным шрифтом выделены обязательные параметры |
Возвращаемое значение
ЭлементСпискаЗначений
— новый элемент списка значений.
Описание
Метод Вставить()
вставляет новый элемент в список значений на позицию с указанным индексом. При этом индексы всех элементов, расположенных ниже указанного в параметре Индекс
, увеличиваются на 1
Доступность
Версия | Поддержка |
---|---|
8.1 | Сервер, Клиент, Внешнее соединение |
8.2 | Сервер, Толстый клиент, Тонкий клиент, Веб-клиент, Внешнее соединение |
8.3 | Сервер, Толстый клиент, Тонкий клиент, Веб-клиент, Внешнее соединение, Мобильный автономный сервер, Мобильный клиент, Мобильное приложение |
Пример использования
Пример кода с использованием метода Вставить()
:
сз = Новый СписокЗначений; сз.Добавить(1); сз.Добавить(2); сз.Добавить(3); ... //добавим значение 0 в начало списка сз.Вставить(0, 0); //проверим результат Сообщить(СтрСоединить(сз.ВыгрузитьЗначения(), ",")); //0,1,2,3