¶ 7. Пользовательские меню. Модуль action
Модуль action позволяет добавлять в приложение пользовательские меню. Добавление таких меню возможно в следующие элементы интерфейса:
- Главное меню
- Контекстное меню задачи
- Контекстное меню сообщения
- Контекстное меню вложения
Примечание
Контекстное меню задачи расположено в нескольких местах: на вкладках Входящие, Мое пространство, К выполнению, Навигатор, а также в Поиске задач. Встраивание пользовательских меню в меню задачи происходит во все перечисленные места.
Контекстное меню вложения расположено в форуме в совокупности с меню сообщений и в поиске вложений. Встраивание пользовательских меню в меню вложений вы встраиваете их в форум и в окно поиска вложений.
Контекстное меню сообщения расположено в форуме задачи.
Каждый добавляемый пункт меню связывается с функцией какого-либо пользовательского модуля. При активации пользователем добавленного пункта, происходит вызов связанной с ним функции. Также пользовательские пункты меню могут иметь иконки и комбинации клавиш для активации с клавиатуры.
Пользовательские меню добавляются в функции init_actions из модуля menu.
action.init_actions()
Вызывается при старте программы, а также в момент обновления Python-модулей при отладке.
action.py:
def init_actions():
...
¶ 7.1 Добавление пользовательских меню
Встраивание пользовательских меню происходит через объекты меню, описанные в модуле actions пакета cerebro. Получить доступ к этим объектам можно через классы модуля actions:
- cerebro.actions.Action - базовый класс действия
- cerebro.actions.Actions - базовый класс меню
- cerebro.actions.AttachmentEditorMenu - контекстное меню вложений в редакторе
- cerebro.actions.AttachmentForumMenu - контекстное меню вложений на форуме
- cerebro.actions.AttachmentForumToolBar - инструментальная панель вложений
- cerebro.actions.AttachmentSearchMenu - контекстное меню вложений в поиске
- cerebro.actions.AttachmentSearchToolBar - инструментальная панель вложений в поиске
- cerebro.actions.MainMenu - главное меню приложения
- cerebro.actions.MessageForumMenu - контекстное меню сообщения на форуме
- cerebro.actions.MessageForumToolBar - инструментальная панель сообщения
- cerebro.actions.TaskActiveMenu - контекстное меню задачи в окне активных задач
- cerebro.actions.TaskNavigatorMenu - контекстное меню задачи в Навигаторе
- cerebro.actions.TaskSearchMenu - контекстное меню задачи в Поиске
- cerebro.actions.TaskToDoListMenu - контекстное меню задачи на вкладке К выполнению
- cerebro.actions.TaskToolBar - инструментальная панель задачи
С помощью этих классов встраиваются пользовательские меню и действия в контекстные меню:
В панели инструментов:
В главное меню приложения:
С примерами добавления пользовательских меню можно ознакомится здесь.