
Работа с контекстным меню элемента формы в 1С
Содержание
Как и в любом другом Windows приложении, в 1С контекстное меню вызывается щелчком правой кнопки мышки на элементе формы. Состав меню и наборы выполняемых команд могут редактироваться:
- Вручную, созданием соответствующего списка и определением набор процедур;
- Автоматически.
Принципам работы с контекстным меню и посвящена наша статья. Мы постараемся рассмотреть вопросы включения, отключения этого элемента на управляемых и обычных формах, а также принципы программного создания списка команд, вызываемых правой кнопкой мышки.
Автоматическое создание контекстного меню
Включение и отключение контекстного меню любого элемента формы происходит непосредственно в конфигураторе. При этом следует иметь ввиду, что для управляемых и для обычных форм возможность выполнения этого действия реализована по-разному.
Допустим, условие задачи предполагает наличие контекстного меню у элемента формы «ТабличныйДокумент». Решим эту задачу для обычной формы внешней обработки.
- Создадим обработку и добавим ей новую форму;
- На форме создадим элемент с типом «ТаблицаЗначений»;
- Откроем меню свойств этого элемента (Рис.1);
Рис.1
- Здесь следует обратить внимание на пункты «АвтоКонтекстноеМеню» и «КонтекстноеМеню».
Выключение галочки «АвтоКонтекстноеМеню» позволяет разработчику создать меню, состоящее только из собственных пунктов. Если же флажок активирован, автоматически созданное меню будет располагаться под списком команд, сформированным пользователем.
В свойствах параметра «КонтекстноеМеню» можно определить типовой список команд, который существует на форме (Рис.2).
В нашем случае мы можем:
- Связать контекстное меню с командной панелью формы обработки;
- Вызвать те же действия, которые включены в выпадающий список команды «Действия»;
- Определить тот же набор пунктов, который реализован в основных действиях формы.
Если мы хотим, чтобы в выпадающем по правому клику списке был реализован набор команд, характерный для табличного поля, мы должны:
- Создать командную панель, для которой источником действий будет выступать наше табличное поле;
- Снять видимость с этого элемента;
- Установить в параметре «КонтекстноеМеню» нашу командную панель.
Решим эту же задачу для управляемых форм. Процесс создания формы и добавление на нее нового реквизита мы отдельно рассматривать не будем. Обратим внимание на тот факт, что не в свойствах поля (Рис.3), не в свойствах реквизита формы, не в свойствах элемента параметра, связанного с контекстным меню нет.
Включить контекстное меню можно, если по элементу формы «Реквизит1» кликнуть правой кнопкой мыши (Рис.4). В выпавшем списке выберем пункт «Показать контекстное меню».
После этого дерево элементов формы получит новую ветку (Рис.5)
Теперь рассмотрим процесс заполнения контекстного меню.
Ручное заполнение пунктов меню
Реализацию ручного заполнения контекстного меню элемента обычной формы можно осуществить простым добавлением кнопок в командную панель, которая определена в соответствующем параметре.
Для управляемой формы набор команд, реализованных в выпадающем списке можно определить, перетаскиванием их с закладки «Команды» в соответствующую ветку дерева элементов (Рис.6).
При этом важно понимать, что в качестве пунктов меню могут выступать не только команды формы, но и стандартные и глобальные команды.
Программное добавление контекстного меню и списка команд в нем
Допустим, перед нами как разработчиками стоит задача в создании в контекстном меню команд, которые перемещают строки табличной части вверх и вниз по списку. Сами процедуры перемещения мы описывать не будем, рассмотрим только программное добавление соответствующих пунктов.
Для этого:
- У формы создадим обработчик события ПриОткрытии;
- Процедуры разместим на клиенте и на сервере, так как для работы нам понадобятся элементы формы, использование директив без контекста не имеет смысла;
- Важное замечание: сами команды должны быть определены и прописаны, иначе запуск обработки не состоится;
- Наша форма будет иметь вид, представленный на Рис.7;
Рис.7
- Перейдем к программированию;
- В первую очередь добавим новые элементы код на Рис.8;
Рис.8
- Определим представление новых элементов и соответствующие команды (Рис.9);
Рис.9
После этих действий контекстное меню будет выглядеть как на Рис.10
Если нам не нужны остальные действия с таблицей, и мы хотим, чтобы меню состояло только из наших пунктов, нам придется добавить еще несколько строк кода.
Первая мысль, которая приходит в голову – отключить автозаполнение. Если бы наше контекстное меню не было создано программно, мы бы так и сделали, однако попытки обнаружить соответствующее свойство у созданного с помощью кода меню (у автора статьи) не увенчались успехом. И было принято решение сделать все предопределенные строки списка невидимыми.
Для этого, перед вышеприведенным кодом был вставлен следующий цикл (Рис.11):
Таким образом, все подчиненные элементы контекстного меню стали не видны, и оно приобрело вид, как на Рис.12