Как сделать кнопку таблицы доступной только при выделенной строке в управляемой форме 1С?

← На главную

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

Разберем детально, как правильно реализовать такое поведение, сравним подходы с точки зрения удобства пользователя (UX) и производительности платформы, а также выясним причину возможных подводных камней при работе с событиями формы.

Вариант 1. Управление свойством Доступность через клиентские события

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

В управляемых формах 1С свойство Доступность принадлежит именно элементу интерфейса (в данном случае объекту типа КнопкаФормы), а не объекту КомандаФормы. Поэтому обращаться следует к коллекции элементов формы: Элементы.ИмяКнопки.Доступность.

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


&НаКлиенте
Процедура ОбновитьДоступностьКоманд()
    
    // Кнопка доступна только в том случае, если в таблице действительно активизирована строка
    Элементы.КоманднаяПанельТаблицыКнопкаДействия.Доступность = 
        (Элементы.Товары.ТекущиеДанные <> Неопределено);
        
КонецПроцедуры

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


&НаКлиенте
Процедура ПриОткрытии(Отказ)
    
    ОбновитьДоступностьКоманд();
    
КонецПроцедуры

&НаКлиенте
Процедура ТоварыПриАктивизацииСтроки(Элемент)
    
    ОбновитьДоступностьКоманд();
    
КонецПроцедуры

&НаКлиенте
Процедура ТоварыПослеУдаления(Элемент)
    
    ОбновитьДоступностьКоманд();
    
КонецПроцедуры

Рассмотрим, как работает эта связка:

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

Вариант 2. Проверка наличия строки внутри действия команды

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


&НаКлиенте
Процедура ВыполнитьДействиеДляСтроки(Команда)
    
    ТекущаяСтрока = Элементы.Товары.ТекущиеДанные;
    Если ТекущаяСтрока = Неопределено Тогда
        ПоказатьПредупреждение(, НСтр("ru = 'Для выполнения команды выберите строку в таблице!'"));
        Возврат;
    КонецЕсли;
    
    // Основная логика обработки данных строки
    ОбработатьСтроку(ТекущаяСтрока);
    
КонецПроцедуры

Сравним достоинства и недостатки обоих подходов:

Производительность: Проверка внутри команды практически не создает нагрузки на интерфейс, так как код выполняется строго в момент клика. Динамическое управление доступностью задействует событие ПриАктивизацииСтроки, которое срабатывает достаточно часто.
Пользовательский опыт (UX): Постоянно активная кнопка, на которую можно нажать в пустой таблице и не получить реакции (если используется тихий Возврат), вызывает у пользователя недоумение. Если выбирать этот вариант, всегда следует выводить поясняющее сообщение через ПоказатьПредупреждение или ПоказатьОповещениеПользователя.
Комплексный интерфейс: Если кнопка привязана к горячим клавишам или выведена не только в командную панель таблицы, но и в главное командное меню формы, отключение только одного элемента интерфейса не блокирует команду полностью. В таком случае проверка внутри команды является обязательной мерой защиты.

Вариант 3. Обработка множественного выделения строк

Рассмотрим более сложную ситуацию: у таблицы включено свойство МножественныйВыбор = Истина. В таком сценарии пользователь может выделить несколько строк с помощью клавиш Shift или Ctrl.

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


&НаКлиенте
Процедура ОбновитьДоступностьКомандМножественногоВыбора()
    
    КоличествоВыделенных = Элементы.Товары.ВыделенныеСтроки.Количество();
    
    // Если команда применима строго к одной строке:
    Элементы.КоманднаяПанельКнопкаДляОднойСтроки.Доступность = (КоличествоВыделенных = 1);
    
    // Если команда обрабатывает группу строк (хотя бы одну):
    Элементы.КоманднаяПанельКнопкаГрупповойОбработки.Доступность = (КоличествоВыделенных > 0);
    
КонецПроцедуры

Подводные камни и рекомендации по оптимизации

Выясним причину частых ошибок, которые допускают разработчики при динамическом управлении кнопками:

Категорический запрет серверных вызовов в ПриАктивизацииСтроки: Событие ПриАктивизацииСтроки вызывается платформой не только при смене строк, но и при кликах мышью по ячейкам, интерактивной навигации стрелками клавиатуры и перерисовке таблицы. Если поместить в это событие серверный вызов (даже с директивой &НаСервереБезКонтекста), интерфейс начнет заметно зависать при перемещении по строкам. Проверка должна выполняться строго на клиенте через обращение к элементам формы.
Программная очистка и заполнение таблицы: При выполнении алгоритмов очистки табличной части (например, вызовом метода Очистить() на сервере) события таблицы ПослеУдаления или ПриАктивизацииСтроки не генерируются. Поэтому после любого программного изменения состава данных необходимо явно вызывать клиентскую процедуру ОбновитьДоступностьКоманд().
Динамические списки с группировками: Если таблица формы отображает динамический список, в котором настроена иерархия или группировка, свойство ТекущиеДанные не равно Неопределено даже при позиционировании на строке-заголовке группы. В таком случае тип текущей строки будет СтрокаГруппировкиДинамическогоСписка. Если действие применимо исключительно к реальным элементам, добавьте проверку типа: ТипЗнч(Элементы.Список.ТекущаяСтрока) <> Тип("СтрокаГруппировкиДинамическогоСписка").

Наиболее надежной практикой в реальных конфигурациях является комбинирование подходов: управление доступностью кнопки через процедуру ОбновитьДоступностьКоманд() на клиенте для обеспечения качественного интерфейса и контрольная проверка ТекущиеДанные <> Неопределено в самом обработчике команды для защиты от непредвиденных состояний формы.