Программное выделение строк в табличном поле 1С

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

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

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

Свойство ВыделениеСтроки для единичного выбора

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

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

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

Элементы.МоеТабличноеПоле.ВыделениеСтроки = СсылкаНаДокумент;

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

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

Работа с множественным выделением через ВыделенныеСтроки

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

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

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

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

Настройка режима выделения в свойствах формы

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

Если ваша логика требует множественного выбора, необходимо установить режим в значение Множественный. Это можно сделать как в палитре свойств элемента формы, так и программно в событии ПриСозданииНаСервере. Изменение этого параметра влияет на то, как система интерпретирует нажатия клавиш Shift и Ctrl при работе с таблицей.

Значение свойства	Описание поведения	Доступные свойства
Нет	Выделение запрещено	Не доступны
Строка	Только одна активная строка	ВыделениеСтроки
Множественный	Выбор нескольких строк	ВыделенныеСтроки
Ячейка	Выделение отдельных ячеек	АктивнаяЯчейка

При переключении режима в runtime следует быть осторожным: если вы переключаете режим с "Множественный" на "Строка" в момент, когда у пользователя уже выделено несколько позиций, система автоматически оставит выделенной только первую строку из списка. Остальные выделения будут потеряны без возможности восстановления через стандартные средства.

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

Определение текущей активной строки

Помимо явного выделения (подсветки цветом), в табличном поле существует понятие активной строки, на которой находится курсор ввода. Это не всегда одно и то же: пользователь может выделить пять строк мышкой, но курсор (активная строка) будет стоять только на одной из них. Для работы с активной строкой используется свойство ТекущаяСтрока.

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

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

Разница между выделением и активностью

Выделение (Selection) — это визуальная подсветка одной или нескольких строк, показывающая пользователю, какие данные выбраны для операции. Активная строка (Current Row) — это позиция курсора, определяющая контекст для ввода данных или вызова команд по одной записи. Они могут не совпадать.

События изменения выделения и их обработка

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

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

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

&НаКлиенте
Процедура ТоварыВыделениеСтрокиИзменено(Элемент)
// Получаем выделенные строки
Выделенные = Элементы.Товары.ВыделенныеСтроки;

Если Выделенные.Количество() = 1 Тогда
// Запускаем получение доп. информации
ОбновитьИнфоОТоваре(Выделенные[0]);
КонецЕсли;
КонецПроцедуры

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

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

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

• 🔹 Автоматическое раскрытие узлов происходит при установке ВыделениеСтроки.
• 🔹 Свойство ТекущаяСтрока также влияет на видимость узла в дереве.
• 🔹 При множественном выделении в иерархии можно выбрать элементы из разных веток дерева.

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

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

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

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

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

Почему свойство ВыделениеСтроки возвращает Неопределено?

Это происходит в двух случаях: либо в табличном поле вообще нет данных, либо пользователь не выделил ни одной строки. Также это возможно, если режим выделения установлен в значение Нет. Проверьте свойство РежимВыделенияСтроки перед попыткой чтения.

Можно ли выделить строку, которой нет в текущем отборе?

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

Как получить индекс выделенной строки в таблице?

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

Влияет ли выделение строки на блокировку данных?

Нет, само по себе выделение строки в интерфейсе не устанавливает никаких блокировок в базе данных. Блокировки возникают только при начале редактирования объекта или выполнении транзакционных операций. Выделение — это исключительно клиентское событие интерфейса.