Как установить текущую строку в таблице значений 1С: методы и примеры

Работа с таблицами значений в 1С:Предприятие 8.3 — одна из самых востребованных задач среди разработчиков. Часто требуется не просто добавить или изменить данные, а программно установить текущую строку, чтобы пользователь видел нужную запись при открытии формы или после выполнения операции. Без правильной установки текущей строки интерфейс может вести себя непредсказуемо: пользователь увидит первую строку вместо актуальной, или таблица прокрутится не туда, куда нужно.

В этой статье разберём все актуальные способы установки текущей строки — от базовых методов встроенного языка до нюансов работы с управляемыми формами и динамическими списками. Особое внимание уделим типичным ошибкам, которые приводят к сбоям, и оптимальным решениям для разных сценариев: от простых обработок до сложных конфигураций с большими объёмами данных.

Что такое текущая строка в таблице значений 1С

Текущая строка — это строка, на которой в данный момент установлен курсор в таблице значений. Она выделяется цветом (по умолчанию синим) и определяет, какая запись будет обработана при нажатии кнопок Удалить, Изменить или других действий. В программном коде текущая строка доступна через свойство ТекущаяСтрока.

Важно понимать разницу между текущей строкой и выделенными строками:

• 🔹 Текущая строка — только одна, определяет позицию курсора.
• 🔹 Выделенные строки — может быть несколько, пользователь выделяет их с помощью Shift или Ctrl.

Если не управлять текущей строкой программно, платформа 1С устанавливает её автоматически — обычно на первую строку после загрузки данных или на последнюю добавленную. Это не всегда удобно: например, после поиска пользователь ожидает увидеть найденную запись, а не начало таблицы.

Способы установки текущей строки в таблице значений

В 1С 8.3 есть несколько методов для установки текущей строки. Выбор зависит от контекста: работаете ли вы с обычной таблицей значений в коде или с элементом формы (например, табличным полем). Рассмотрим все варианты.

1. Метод ТекущаяСтрока() для обычной таблицы значений

Если у вас есть объект типа ТаблицаЗначений, можно использовать метод ТекущаяСтрока(). Он принимает в качестве параметра либо индекс строки (нумерация с 0), либо саму строку.

// Пример 1: Установка по индексу
Таблица.ТекущаяСтрока(2); // Установит курсор на третью строку (индекс 2)

// Пример 2: Установка по объекту строки
Строка = Таблица.НайтиСтроку(Новый Структура("Код, Наименование", 123, "Товар1"));
Если Строка <> Неопределено Тогда
Таблица.ТекущаяСтрока(Строка);
КонецЕсли;

Обратите внимание: если передать несуществующий индекс, метод не вызовет ошибку, но текущая строка не изменится. Это может привести к скрытым багам, если не проверять результат.

2. Работа с табличным полем в управляемой форме

В управляемых формах таблица значений отображается через элемент ПолеТаблицы. Здесь метод ТекущаяСтрока работает иначе — он относится к визуальному отображению, а не к данным. Чтобы установить текущую строку, нужно:

1. Получить данные таблицы через ЭлементыФормы.ИмяПоля.Значение.
2. Установить текущую строку в самой таблице значений.
3. Обновить отображение с помощью Обновить().

// Пример для управляемой формы
ТаблицаДанных = ЭлементыФормы.ТабличноеПоле.Значение;
ТаблицаДанных.ТекущаяСтрока(ИндексСтроки);
ЭлементыФормы.ТабличноеПоле.Обновить();

Если пропустить вызов Обновить(), изменения применятся только к данным, но не к интерфейсу — пользователь не увидит смены строки.

Существует ли строка с указанным индексом?

Таблица не пустая?

Для управляемых форм вызван метод Обновить()?

Учтена разница между индексами (с 0) и номерами строк (с 1)?-->

3. Использование метода НайдиСтроки() для поиска

Когда нужно установить текущую строку по определённому условию (например, по коду или наименованию), удобно использовать метод НайтиСтроки(). Он возвращает массив строк, соответствующих критерию, после чего можно установить текущую строку на первую найденную.

НайденныеСтроки = Таблица.НайтиСтроки(Новый Структура("Артикул", "АРТ-001"));
Если НайденныеСтроки.Количество() > 0 Тогда
Таблица.ТекущаяСтрока(НайденныеСтроки[0]);
КонецЕсли;

Этот способ полезен для динамического поиска, но имеет нюанс: если строк несколько, текущей станет первая. Если нужно выделить все найденные, потребуется дополнительная логика.

Особенности работы с динамическими списками

Динамические списки в 1С — это отдельная тема. Они не являются таблицами значений, но часто используются для отображения данных в формах. Здесь установка текущей строки имеет свои правила:

• 🔹 Для динамического списка текущая строка устанавливается через свойство ТекущаяСтрока самого списка, а не его данных.
• 🔹 Изменения применяются только после вызова Обновить().
• 🔹 Если строка не найдена, свойство вернёт Неопределено.

// Пример для динамического списка
ТекущийЭлемент = ЭлементыФормы.ДинамическийСписок.ТекущаяСтрока;
ЭлементыФормы.ДинамическийСписок.ТекущаяСтрока = НайденнаяСтрока;
ЭлементыФормы.ДинамическийСписок.Обновить();

⚠️ Внимание: В динамических списках при установке текущей строки по объекту (не по индексу) важно убедиться, что объект принадлежит именно этому списку. Иначе возникнет ошибка "Неверный тип данных".

Типичные ошибки и как их избежать

Даже опытные разработчики иногда сталкиваются с проблемами при работе с текущими строками. Вот самые распространённые ошибки и способы их решения:

Критическая особенность: В управляемых формах при программном изменении текущей строки может сработать событие ПриИзмененииТекущейСтроки. Если в обработчике этого события есть код, зависящий от текущей строки, возможна рекурсия или зацикливание. Всегда проверяйте условия в таких обработчиках!

Практические примеры использования

Рассмотрим реальные сценарии, где установка текущей строки необходима.

1. Автоматическое позиционирование после добавления строки

После добавления новой строки в таблицу логично показать её пользователю. Например, при добавлении товара в документ:

НоваяСтрока = ТаблицаДокумента.Добавить();
НоваяСтрока.Товар = ВыбранныйТовар;
НоваяСтрока.Количество = 1;
// Устанавливаем текущую строку на новую
ТаблицаДокумента.ТекущаяСтрока(ТаблицаДокумента.Количество() - 1);

2. Поиск и выделение строки по условию

Допустим, пользователь ввёл артикул в поле поиска, и нужно найти соответствующую строку:

АртикулДляПоиска = ЭлементыФормы.ПолеПоиска.Значение;
НайденныеСтроки = ТаблицаТоваров.НайтиСтроки(Новый Структура("Артикул", АртикулДляПоиска));
Если НайденныеСтроки.Количество() > 0 Тогда
ТаблицаТоваров.ТекущаяСтрока(НайденныеСтроки[0]);
ЭлементыФормы.ТаблицаТоваров.Обновить();
Иначе
Сообщить("Товар не найден!");
КонецЕсли;

3. Сохранение и восстановление позиции

Если таблица обновляется (например, при фильтрации), но нужно сохранить позицию пользователя:

// Сохраняем текущую строку перед обновлением
ТекущийИндекс = Таблица.ТекущаяСтрока.Индекс;
// ... код обновления таблицы
Если ТекущийИндекс < Таблица.Количество() Тогда
Таблица.ТекущаяСтрока(ТекущийИндекс);
КонецЕсли;

Оптимизация производительности

При работе с большими таблицами значений (тысячи строк) установка текущей строки может тормозить интерфейс. Вот как оптимизировать процесс:

• 🔹 Индексируйте таблицу перед поиском: Таблица.Индексировать("КолонкаДляПоиска").
• 🔹 Избегайте частых обновлений формы — группируйте изменения.
• 🔹 Используйте отложенное обновление: ЭлементыФормы.Таблица.ОтложенноеОбновление = Истина;.

Для динамических списков актуально использовать серверные вызовы для поиска, чтобы не грузить клиент:

&НаСервере
Процедура НайтиСтрокуНаСервере(ЗначениеПоиска)
Результат = Запрос.Выполнить("ВЫБРАТЬ Ссылка ИЗ Справочник.Товары ГДЕ Артикул = &Артикул").Выгрузить();
Возврат Результат[0].Ссылка;
КонецПроцедуры

⚠️ Внимание: В веб-клиенте и тонком клиенте некоторые методы работы с таблицами значений могут работать медленнее, чем в толстом. Тестируйте производительность на целевой платформе.

FAQ: Частые вопросы по текущим строкам в 1С

ТекущийИндекс = Таблица.ТекущаяСтрока.Индекс;

Процедура ПриОткрытии()
ЭлементыФормы.Список.ТекущаяСтрока = НайденнаяСтрока;
КонецПроцедуры