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