К статье
Практический материал

Другое · 8 мин

Как установить текущую строку в динамическом списке 1С

Разберём, как программно задать текущую строку динамического списка в 1С:Предприятии, когда это работает, в чём отличие от выделения и какие ошибки избегать.

Динамический список в 1С:Предприятии — это форма отбора и отображения данных, которая строится по настройкам отбора, порядка и отображаемых полей. На форме такой список обычно представляется элементом управления типа «Список» или «Динамический список», а текущая строка — это запись, на которой сфокусирован пользователь и которая считается активной для дальнейших действий.

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

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

Что означает текущая строка динамического списка

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

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

Где и когда можно задать текущую строку

Текущую строку можно задать на форме списка, форме документа, форме справочника или в любой другой управляемой форме, где есть элемент, связанный с динамическим списком. Главное условие — к моменту установки список уже должен содержать данные. Если попытаться задать текущую строку до загрузки, платформа проигнорирует действие, потому что ещё не знает, какие строки существуют.

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

Порядок действий
  1. 1
    Открыть форму со списком и дождаться загрузки данных
  2. 2
    Получить ссылку на нужную запись
  3. 3
    Присвоить ссылку свойству ТекущаяСтрока элемента формы
  4. 4
    Проверить, что фокус переместился на нужную строку

Как программно установить текущую строку в управляемой форме

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

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

Контрольные точки

Как проверить результат

Визуальное выделение строки после открытия
Норма

Нужная запись активна и фокусирована

Тревожный признак

Фокус остался на первой или другой записи

Результат действия над текущей строкой
Норма

Открыта карточка ожидаемой записи

Тревожный признак

Открыта другая запись или действие недоступно

Установка после загрузки данных и проверка результата

Установку текущей строки нужно выполнять только после того как динамический список наполнился данными. В управляемом приложении это часто означает вызов в обработчике ПриОткрытии или после завершения загрузки, когда элементы формы уже доступны и список содержит строки. Ранняя установка, например в начале открытия формы, обычно не даёт эффекта.

Проверка результата заключается в визуальном подтверждении: нужная строка должна быть выделена как текущая, а свойство ТекущиеДанные или эквивалентное значение элемента должно соответствовать ожидаемой записи. Можно также выполнить тестовое действие над текущей строкой, например открыть её карточку, чтобы убедиться, что платформа работает именно с нужной записью.

Отличие текущей строки от выделения и отбора

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

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

Типичные ошибки
01
Установка текущей строки до загрузки данных — действие игнорируется
02
Присвоение значения, отсутствующего в списке — фокус не перемещается
03
Смешение текущей строки и множественного выделения — работа ведётся не с той записью

Ограничения и частые ошибки

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

Частая ошибка — попытка присвоить свойству ТекущаяСтрока значение, которое не соответствует ни одной строке текущего списка. Это приводит к тому, что фокус не перемещается или перемещается на неправильную запись. Другая ошибка — смешивание текущей строки с выделением, из-за чего программа действует с одной записью, а пользователь видит выделенную другую.

Сравнение вариантов

Установка через ТекущаяСтрока элемента формы

Подходит, когда нужно явно сфокусировать пользователя на конкретной записи после загрузки списка.

Отбор, оставляющий одну запись

Подходит, когда достаточно сузить список до нужной строки, без программного управления фокусом.

Альтернативные подходы и когда не стоит менять текущую строку

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

Не стоит менять текущую строку при каждом открытии формы, если это не обосновано бизнес-логикой. Частые программные перемещения фокуса могут сбивать пользователя с толку и затруднять работу с длинными списками. Установку целесообразно применять точечно: после создания записи, после исправления ошибки или при переходе из связанного документа.

Итог

Что важно запомнить

Текущую строку динамического списка задают через свойство элемента формы только после загрузки данных, а затем проверяют, что фокус действительно переместился на нужную запись.

Часто задаваемые вопросы

Можно ли установить текущую строку до открытия формы?

Обычно нет, потому что к моменту открытия список ещё не заполнен, и платформа не знает, какие строки существуют. Установку выполняют после загрузки данных, например в обработчике открытия формы или после завершения чтения списка.

Чем текущая строка отличается от выделения?

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

Что делать, если нужная запись отсутствует в списке?

Сначала измените отбор или загрузите данные так, чтобы нужная запись попала в текущий набор. Только после этого можно попытаться сделать её текущей, иначе установка не даст эффекта.

Нужно ли проверять результат после установки?

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

Можно ли обойтись без программной установки текущей строки?

Иногда достаточно настроить отбор так, чтобы в списке осталась одна подходящая запись. Тогда пользователь сам увидит нужную строку, и дополнительного программного управления фокусом не требуется.