Как выделить строчку в 1С: методы управления курсором и выделением

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

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

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

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

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

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

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

Методы работы с табличным документом на клиенте

Наиболее распространенный сценарий выделения строки возникает при работе с объектом ТабличныйДокумент или списком формы. Для программного перемещения курсора и установки выделения используется метод УстановитьАктивность в сочетании со свойствами области. Однако, если речь идет именно о списке значений или списке формы, основным инструментом является метод ВыделитьСтроку.

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

&НаКлиенте
Процедура ВыделитьНужнуюСтроку(СсылкаНаОбъект)
// Получаем текущие выделенные строки
ВыделенныеСтроки = ЭлементыФормы.Список.ВыделенныеСтроки;

// Очищаем предыдущее выделение, если нужно
ЭлементыФормы.Список.ВыделенныеСтроки.Очистить();

// Ищем индекс строки по ссылке
ИндексСтроки = ЭлементыФормы.Список.НайтиПоСсылке(СсылкаНаОбъект);

Если ИндексСтроки <> Неопределено Тогда
ЭлементыФормы.Список.ТекущаяСтрока = ИндексСтроки;
ЭлементыФормы.Список.ВыделитьСтроку(ИндексСтроки);
КонецЕсли;
КонецПроцедуры

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

Работа с реквизитом «ТекущаяСтрока» в списке формы

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

Однако простое изменение индекса не всегда гарантирует, что строка будет визуально подсвечена как "выбранная" в привычном понимании (синим фоном). В некоторых версиях платформы и конфигурациях интерфейса изменение текущей строки лишь перемещает рамку фокуса. Для гарантированного визуального эффекта часто требуется явный вызов метода выделения сразу после смены индекса.

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

• 🎯 Свойство ТекущаяСтрока принимает значение индекса (число) или неопределено.
• 👁️ Метод ВыделитьСтроку обеспечивает визуальный акцент на элементе.
• 🌳 При работе с иерархией проверяйте свойство Раскрыть у родительских узлов.

Выделение нескольких строк одновременно

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

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

Рассмотрим пример, где мы выделяем все строки, удовлетворяющие определенному условию, например, помеченные на удаление или имеющие определенный статус. Мы очищаем текущий список выделений, проходим циклом по всем строкам и добавляем нужные индексы в коллекцию.

&НаКлиенте
Процедура ВыделитьВсеАктивныеСтроки()
СписокВыделения = ЭлементыФормы.Список.ВыделенныеСтроки;
СписокВыделения.Очистить();

Для Каждого ТекущаяСтрока Из ЭлементыФормы.Список Цикл
Если ТекущаяСтрока.Статус = Перечисления.Статусы.Активен Тогда
СписокВыделения.Добавить(ТекущаяСтрока.Индекс);
КонецЕсли;
КонецЦикла;

// Принудительная запись изменений в интерфейс
ЭлементыФормы.Список.ВыделенныеСтроки = СписокВыделения;
КонецПроцедуры

⚠️ Внимание: При выделении большого количества строк (сотни и тысячи) интерфейс может временно "зависнуть" из-за перерисовки. Рекомендуется использовать индикатор прогресса или ограничивать количество одновременно выделяемых элементов.

Специфика работы в управляемых формах

Архитектура управляемых форм накладывает определенные ограничения на прямой доступ к элементам управления. В отличие от обычных форм, здесь мы работаем с объектами метаданных и их представлениями. Механизм выделения строк в управляемых формах тесно связан с механизмом команд и обработчиков событий.

Часто разработчики сталкиваются с ситуацией, когда код выполняется на сервере в обработчике команды, но попытка выделить строку не дает результата. Это происходит потому, что серверный контекст не может напрямую управлять клиентским интерфейсом. Решением является использование инструкций &НаКлиенте и передача необходимых параметров из серверного контекста.

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

Контекст выполнения	Доступ к интерфейсу	Рекомендуемый метод
Клиент	Полный	Прямой вызов ВыделитьСтроку
Сервер	Отсутствует	Возврат параметров клиенту
Внешнее соединение	Ограниченный	Через COM-объект формы
Мобильный клиент	Специфичный	Через команды формы

Почему не работает выделение из сервера?

Серверная часть 1С работает в отдельном процессе и не имеет доступа к окнам операционной системы пользователя. Любые попытки изменить интерфейс должны инициироваться клиентским кодом.

Обработка событий изменения выделения

Для создания реактивных интерфейсов важно не только программно выделять строки, но и реагировать на действия пользователя. Событие ПриИзмененииВыделенныхСтрок позволяет отслеживать любые изменения в выборе элементов списка. Это событие срабатывает как при клике мышью, так и при программном изменении коллекции выделения.

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

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

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

⚠️ Внимание: Интерфейс платформы 1С регулярно обновляется. Поведение событий и методов может незначительно меняться в новых релизах. Сверяйте актуальную документацию по синтаксису в справочной системе конфигурации или на портале ИТС.

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

Как выделить строку, если список формы пуст?

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

Можно ли выделить строку в иерархическом списке, если она свернута?

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

Почему метод ВыделитьСтроку не подсвечивает строку цветом?

Чаще всего это связано с тем, что фокус ввода находится на другом элементе формы. Выделение строки в списке часто визуально отображается только тогда, когда сам список имеет фокус. Попробуйте добавить команду ЭлементыФормы.Список.Активизировать() перед выделением строки.

Как снять выделение со всех строк программно?

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

Работает ли выделение строк в мобильных клиентах 1С?

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