Список значений в 1С 8.3

Курс

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

Создание списка значений

Конструктор для создания пустого списка значений:

Как добавить значение в список значений

Добавление новых элементов список значений возможно двумя способами: методом Добавить и методом Вставить. У метода Вставить можно указать индекс куда будет вставлено новое значение.

Удаление элемента из списка значений

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

Как получить значение списка значений по индексу

Для получения значения списка значений можно воспользоваться методом Получить или оператором индексации [ ], указав нужный индекс элемента. Стоит отметить, что таким образом будет получен элемент списка значений, а не само значение. Для получения значения нужно обратиться к свойству Значение:

Список значений и массив

Метод ЗагрузитьЗначения позволяет загрузить все значения из массива в список значений. Если в списке значений уже что-то было, то все элементы будут удалены из него. Метод ВыгрузитьЗначения создает массив и выгружает в него все значения из списка значений:

Сортировка списка значений

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

Количество элементов списка значений

Чтобы узнать сколько в списке значений элементов применяется метод Количество.

Поиск в списке значений

Метод НайтиПоЗначению позволяет найти элемент списка значений. Параметром передается значение, которое нужно найти в списке. Данный метод вернет элемент списка, если есть элемент с таким значением, и Неопределено, если такого элемента нет.

Как создать копию списка значений

Для создания полной копии списка значений удобно использовать метод Скопировать:

Выбор из списка значений

Список значений позволяет интерактивно выбрать из него значение. Для этого используется метод ПоказатьВыборЭлемента. При этом в форме выбора будет отображаться именно представление элемента списка значений, а не значение:

В результате на экран будет выведена форма для выбора значения:

После выбора программа сообщит какой элемент был выбран:

Для возможности выбора нескольких элементов используется метод ПоказатьОтметкуЭлементов. В этом случае на форме выбора, помимо представлений элементов, будет возможность отметить флажком выбранные элементы.

В результате будет открыта форма с возможностью установки галочки возле каждого значения списка:

После выбора программа сообщит какие элементы были выбраны:

Перебор списка значений

Перебрать список значений можно как с помощью цикла Для Каждого, так и с помощью цикла Для. В обоих случаях при изменении значения в элементе списка, в самом списке значений значение тоже будет изменено.

Как типизировать список значений

Для ограничения возможных типов списка значений нужно заполнить его свойство ТипЗначения:

Как ограничить возможные значения в списке значений

Также можно ограничить список возможных добавляемых значений в список значений. Для этого в свойстве ДоступныеЗначения нужно указать ссылку на другой список значений. Тогда в список значений можно будет добавлять значения только из списка в свойстве ДоступныеЗначения, все остальные значения будут преобразованы в Неопределено:


Подписывайтесь на группу ВКонтакте , где я публикую ссылки на новые статьи с данного сайта, а также интересные материалы с других ресурсов по программированию в 1С
Понравилась статья? Поделиться с друзьями:
Добавить комментарий

;-) :| :x :twisted: :smile: :shock: :sad: :roll: :razz: :oops: :o :mrgreen: :lol: :idea: :grin: :evil: :cry: :cool: :arrow: :???: :?: :!:

Используя этот сайт, Вы даете согласие на использование cookies. На данном этапе Вы можете отказаться от использования cookies, настроив необходимые параметры в своем браузере.
ok