Мука
Дрожжи
Соль
+

СписокЗначений — упорядоченная коллекция, как Массив, но у каждого элемента не одно значение, а объект ЭлементСпискаЗначений с четырьмя свойствами:

СвойствоТипОписание
ЗначениеПроизвольныйсамо значение — то, ради чего элемент нужен
ПредставлениеСтрокакак показать элемент пользователю; по умолчанию — строковое представление Значение
ПометкаБулевоотметка/флажок — для списков с множественным выбором
КартинкаКартинкаиконка рядом с элементом в интерфейсе
Список = Новый СписокЗначений;
Список.Добавить(1, "Первый сорт");
Список.Добавить(2, "Высший сорт");
 
Элемент = Список[0];
Элемент.Значение;        // 1
Элемент.Представление;   // "Первый сорт"

Из-за Представление и Пометка список значений — стандартный источник данных для полей выбора и списков с флажками в формах, а не просто хранилище значений, как Массив.

Конструктор · Обход · Сортировка · Особенности и ограничения

Методы

Добавление

МетодЧто делает
Добавить(Значение, Представление, Пометка, Картинка)добавить элемент в конец
Вставить(Индекс, …)вставить элемент по индексу

Поиск

МетодЧто делает
НайтиПоЗначению(Значение)элемент с таким значением или Неопределено
НайтиПоИдентификатору(Идентификатор)элемент по стабильному внутреннему идентификатору

Сортировка и обмен с массивом

МетодЧто делает
СортироватьПоЗначению(Направление)отсортировать по Значение
СортироватьПоПредставлению(Направление)отсортировать по Представление
ВыгрузитьЗначения()значения всех элементов в Массив
ЗагрузитьЗначения(Массив)заменить содержимое списка значениями из Массива

Порядок, удаление, копия

МетодЧто делает
Сдвинуть(Элемент, Смещение)переместить элемент вверх/вниз
Удалить(Элемент) / Очистить()удалить элемент / все элементы
Скопировать()независимая копия списка

в этой папке 12 элементов

01
Вставить()

Вставка элемента списка значений по индексу — остальные элементы сдвигаются вниз.

Открыть →
02
ВыгрузитьЗначения() и ЗагрузитьЗначения()

Обмен между списком значений и обычным Массивом — в обе стороны, без Представления/Пометки/Картинки.

Открыть →
03
Добавить()

Добавление элемента в список значений — значение, представление, пометка и картинка.

Открыть →
04
Конструктор списка значений

Новый СписокЗначений — всегда пустой список, без параметризованных вариантов.

Открыть →
05
НайтиПоЗначению()

Поиск элемента списка значений по его свойству Значение.

Открыть →
06
НайтиПоИдентификатору()

У каждого элемента списка значений есть стабильный внутренний идентификатор — поиск по нему переживает смену значения и перестановки.

Открыть →
07
Обход списка значений

Для Каждого Элемент Из СписокЗначений — порядок гарантирован, доступ к Значению, Представлению и Пометке.

Открыть →
08
Особенности и ограничения

Передача по ссылке, доступ по индексу, интерактивный выбор ОтметитьЭлементы(), место списка значений среди других коллекций.

Открыть →
09
Сдвинуть()

Сдвинуть() перемещает элемент списка значений вверх или вниз на заданное число позиций.

Открыть →
10
Скопировать()

Скопировать() возвращает независимую копию списка значений — присваивание копирует лишь ссылку.

Открыть →
11
СортироватьПоЗначению() и СортироватьПоПредставлению()

Два метода сортировки списка значений — по значению и по видимому представлению, оба меняют список на месте.

Открыть →
12
Удаление данных из списка значений

Удалить() убирает один элемент, Очистить() — все сразу.

Открыть →