Добавление контекстного меню к табличному полю в 1С

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

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

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

Архитектура команд в платформе 1С:Предприятие

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

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

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

Создание новой команды интерфейса

Процесс добавления нового пункта в меню начинается с создания объекта команды в конфигураторе. Откройте нужную форму в дереве метаданных и найдите ветку Команды. Именно здесь хранятся все доступные действия для данной формы. Щелкните правой кнопкой мыши и выберите добавление новой команды.

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

После выбора типа использования становится активным свойство Группа команд. Оно позволяет логически сгруппировать ваши новые пункты с системными командами платформы, такими как "Изменить", "Пометить на удаление" или "Копировать". Если вы хотите, чтобы ваша команда отображалась в отдельной группе или в конце списка, оставьте это поле пустым или создайте собственную группу.

Настройка табличного поля на форме

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

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

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

Написание обработчика события

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

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

Процедура КомандаОбработчика(Команда)

// Получаем ссылку на активное табличное поле
ТабПоле = Элементы.ИмяТабличногоПоля;

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

// Логика обработки выделенной строки
ДокументОбъект = ТабПоле.ТекущиеДанные;
// ... дальнейший код

КонецПроцедуры

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

Особенности серверного вызова

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

Управление видимостью команд

Не все команды должны быть доступны пользователю постоянно. Ситуативная видимость — мощный инструмент UX, позволяющий скрывать пункты меню, если они не могут быть выполнены в текущий момент. Например, команда "Сформировать акт" не должна быть видна, если документ еще не проведен.

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

Свойство	Тип значения	Описание влияния
Видимость	Булево / Процедура	Полностью скрывает команду из меню, если значение Ложь.
Доступность	Булево / Процедура	Оставляет команду в меню, но делает её неактивной (серой).
Важность	Перечисление	Влияет на отображение в переполненном меню (обычное, обычное, важное).
Группа команд	Строка	Определяет визуальный блок, к которому относится пункт меню.

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

Типичные ошибки и отладка

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

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

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

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

⚠️ Внимание: Интерфейс и свойства объектов могут незначительно отличаться в зависимости от версии платформы 1С:Предприятие (8.2, 8.3, 8.3.20+). Всегда сверяйте точные названия свойств в справке по вашей конкретной версии конфигурации.

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

Можно ли добавить иконку к пункту контекстного меню?

Да, у объекта Команда есть свойство Картинка. Вы можете загрузить любое изображение из библиотеки картинок конфигурации. Однако стоит учитывать, что в некоторых темах оформления интерфейса (скинах) иконки в контекстных меню могут отображаться мелкими или не отображаться вовсе, в зависимости от настроек клиента 1С.

Почему моя команда не видна конкретному пользователю?

Проверьте настройки прав доступа (РПИ). Даже если команда добавлена в форму, у роли пользователя должно быть право на выполнение этой команды. Также проверьте свойство Видимость: возможно, процедура проверки возвращает Ложь для данных этого пользователя.

Как вызвать контекстное меню программно?

Прямого метода "ОткрытьКонтекстноеМеню" у табличного поля нет. Однако вы можете программно выполнить команду, которая находится в этом меню, обратившись к ней через коллекцию команд формы: Форма.Команды.ИмяКоманды.Выполнить().

Можно ли динамически менять состав меню в зависимости от выделенной строки?

Состав команд (список доступных пунктов) статичен и определяется при открытии формы. Однако вы можете динамически управлять свойствами Видимость и Доступность каждой отдельной команды в момент открытия меню, создавая эффект изменения состава.