Синтаксис и применение Таблица значений в платформе 1С:Предприятие. Описание и примеры кода.
Полное описание, параметры и ограничения
Таблица значений
Таблица значений
Таблица значений - это несохраняемый в базе данных объект, который позволяет строить динамические наборы значений и манипулировать ими (добавлять, редактировать, удалять элементы, сортировать). Он может быть наполнен значениями любого типа, т.е. в одной таблице типы хранимых значений могут быть разными. Одним из примеров использования данного объекта может служить организация представления в форме списка элементов справочника, отобранных по сложному алгоритму.
Необходимо отметить, что таблица значений, связанная с элементом управления ТабличноеПоле, будет иметь все колонки, имеющиеся в табличном поле, с соответствующими именами. Кроме того, таблица значений может иметь также и собственные колонки, не отображаемые в табличном поле, при этом их имена должны отличаться от имен колонок табличного поля.
Методическая информация
Практические примеры
Проверить РежимВводаСтрокТабличногоПоля.ПередТекущейСтрокой на собственных данных
Небольшой опыт с подготовленной своей формой, элементом или именованным макетом. Код показывает настоящего получателя настройки, а не универсальную getter-обёртку.
Где и как запускать
ПриОткрытии своей обычной формы, толстый клиент.
Подготовка
Своя обработка с обычной формой, толстый клиент. Реквизит Товары типа ТаблицаЗначений, колонки Наименование Строка 100 и Количество Число 10.0.
Разместите обычное табличное поле Товары, данные Товары, и две колонки с именами Наименование и Количество. Включите изменение состава строк и штатные команды Добавить / Вставить.
Основной блок — ПриОткрытии этой обычной формы. ЭлементыФормы нельзя переносить в управляемую форму.
Процедура ПриОткрытии()
Товары = Новый ТаблицаЗначений;
Товары.Колонки.Добавить("Наименование");
Товары.Колонки.Добавить("Количество");
СтрокаТовара = Товары.Добавить();
СтрокаТовара.Наименование = "Учебная книга";
СтрокаТовара.Количество = 3;
СтрокаТовара = Товары.Добавить();
СтрокаТовара.Наименование = "Учебная тетрадь";
СтрокаТовара.Количество = 5;
ЭлементыФормы.Товары.РежимВводаСтрок = РежимВводаСтрокТабличногоПоля.ПередТекущейСтрокой;
Сообщить("Собственный опыт: ПередТекущейСтрокой");
КонецПроцедурыРазбор по шагам
Подготовьте описанные свои реквизиты, элементы и при необходимости именованный макет.
Назначьте код указанному событию настоящей формы.
Выполните ручное действие из проверки и сравните выбранный режим на тех же данных.
Как проверить результат
Активизируйте первую строку и штатно добавьте третью: сравните ПередТекущейСтрокой, ПослеТекущейСтроки, ВКонецСписка и ВКонецОкна.
Демонстрируется интерактивное добавление обычного табличного поля, не вызов ТаблицаЗначений.Добавить.
Ожидаемый результат
Настройка связана с конкретным собственным элементом, типом данных и воспроизводимым действием.
На что обратить внимание
Обычные и управляемые элементы отличаются. Не переносите обработчики между ними только по сходству имён.
Readonly-свойства не присваиваются; конфигурация, версия платформы и рабочие объекты в коде не проверяются и не изменяются.
При подготовке HTML BSL не исполнялся; факт запуска этого опыта в 1С не подтверждён.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.