Source Code for Module gui.menu

  1  ############################################################################### 
  2  #                                                                             # 
  3  # Copyright (C) 2009 Michael Bieri                                            # 
  4  # Copyright (C) 2010-2013 Edward d'Auvergne                                   # 
  5  #                                                                             # 
  6  # This file is part of the program relax (http://www.nmr-relax.com).          # 
  7  #                                                                             # 
  8  # This program is free software: you can redistribute it and/or modify        # 
  9  # it under the terms of the GNU General Public License as published by        # 
 10  # the Free Software Foundation, either version 3 of the License, or           # 
 11  # (at your option) any later version.                                         # 
 12  #                                                                             # 
 13  # This program is distributed in the hope that it will be useful,             # 
 14  # but WITHOUT ANY WARRANTY; without even the implied warranty of              # 
 15  # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the               # 
 16  # GNU General Public License for more details.                                # 
 17  #                                                                             # 
 18  # You should have received a copy of the GNU General Public License           # 
 19  # along with this program.  If not, see <http://www.gnu.org/licenses/>.       # 
 20  #                                                                             # 
 21  ############################################################################### 
 22   
 23  # Module docstring. 
 24  """The main relax menu bar.""" 
 25   
 26  # Python module imports. 
 27  import sys 
 28  import wx 
 29   
 30  # relax module imports. 
 31  from graphics import fetch_icon 
 32  from gui.components.menu import build_menu_item 
 33  from gui.uf_objects import build_uf_menus, Uf_storage; uf_store = Uf_storage() 
 34  from status import Status; status = Status() 
 35  from user_functions.data import Uf_info; uf_info = Uf_info() 
 36   
 37   
 38 -class Menu: 
 39      """The menu bar GUI class.""" 
 40   
 41      # Some IDs for the menu entries. 
 42      MENU_FILE_NEW = wx.NewId() 
 43      MENU_FILE_CLOSE = wx.NewId() 
 44      MENU_FILE_CLOSE_ALL = wx.NewId() 
 45      MENU_FILE_OPEN = wx.NewId() 
 46      MENU_FILE_SAVE = wx.NewId() 
 47      MENU_FILE_SAVE_AS = wx.NewId() 
 48      MENU_FILE_EXPORT_BMRB = wx.NewId() 
 49      MENU_FILE_EXIT = wx.NewId() 
 50      MENU_VIEW_CONTROLLER = wx.NewId() 
 51      MENU_VIEW_SPIN_VIEW = wx.NewId() 
 52      MENU_VIEW_RESULTS = wx.NewId() 
 53      MENU_VIEW_PIPE_EDIT = wx.NewId() 
 54      MENU_VIEW_PROMPT = wx.NewId() 
 55      MENU_TOOLS_FORMAT = wx.NewId() 
 56      MENU_TOOLS_TEST_SUITE = wx.NewId() 
 57      MENU_TOOLS_TEST_SUITE_ALL = wx.NewId() 
 58      MENU_TOOLS_TEST_SUITE_SYS = wx.NewId() 
 59      MENU_TOOLS_TEST_SUITE_UNIT = wx.NewId() 
 60      MENU_TOOLS_TEST_SUITE_GUI = wx.NewId() 
 61      MENU_TOOLS_SYS_INFO = wx.NewId() 
 62      MENU_HELP_MANUAL = wx.NewId() 
 63      MENU_HELP_MAIL = wx.NewId() 
 64      MENU_HELP_REFS = wx.NewId() 
 65      MENU_HELP_GPL = wx.NewId() 
 66      MENU_HELP_ABOUT = wx.NewId() 
 67   
 68 -    def __init__(self, gui): 
 69          """Build the menu bar.""" 
 70   
 71          # Store the args. 
 72          self.gui = gui 
 73   
 74          # Create the menu bar GUI item. 
 75          self.menubar = wx.MenuBar() 
 76   
 77          # The 'File' menu entries. 
 78          menu = wx.Menu() 
 79          menu.AppendItem(build_menu_item(menu, id=self.MENU_FILE_NEW, text="&New analysis\tCtrl+N", icon=fetch_icon('oxygen.actions.document-new', "16x16"))) 
 80          menu.AppendItem(build_menu_item(menu, id=self.MENU_FILE_CLOSE, text="&Close analysis", icon=fetch_icon('oxygen.actions.document-close', "16x16"))) 
 81          menu.AppendItem(build_menu_item(menu, id=self.MENU_FILE_CLOSE_ALL, text="&Close all analyses", icon=fetch_icon('oxygen.actions.dialog-close', "16x16"))) 
 82          menu.AppendSeparator() 
 83          menu.AppendItem(build_menu_item(menu, id=self.MENU_FILE_OPEN, text="&Open relax state\tCtrl+O", icon=fetch_icon('oxygen.actions.document-open', "16x16"))) 
 84          menu.AppendItem(build_menu_item(menu, id=self.MENU_FILE_SAVE, text="S&ave relax state\tCtrl+S", icon=fetch_icon('oxygen.actions.document-save', "16x16"))) 
 85          menu.AppendItem(build_menu_item(menu, id=self.MENU_FILE_SAVE_AS, text="Save as...\tCtrl+Shift+S", icon=fetch_icon('oxygen.actions.document-save-as', "16x16"))) 
 86          menu.AppendSeparator() 
 87          menu.AppendItem(build_menu_item(menu, id=self.MENU_FILE_EXPORT_BMRB, text="Export for BMRB deposition", icon=fetch_icon('relax.bmrb'))) 
 88          menu.AppendSeparator() 
 89          menu.AppendItem(build_menu_item(menu, id=self.MENU_FILE_EXIT, text="E&xit\tCtrl+Q", icon=fetch_icon('oxygen.actions.system-shutdown', "16x16"))) 
 90          self.menubar.Append(menu, "&File") 
 91   
 92          # The 'File' menu actions. 
 93          self.gui.Bind(wx.EVT_MENU, self.gui.analysis.menu_new, id=self.MENU_FILE_NEW) 
 94          self.gui.Bind(wx.EVT_MENU, self.gui.analysis.menu_close, id=self.MENU_FILE_CLOSE) 
 95          self.gui.Bind(wx.EVT_MENU, self.gui.analysis.menu_close_all, id=self.MENU_FILE_CLOSE_ALL) 
 96          self.gui.Bind(wx.EVT_MENU, self.gui.state_load, id=self.MENU_FILE_OPEN) 
 97          self.gui.Bind(wx.EVT_MENU, self.gui.action_state_save, id=self.MENU_FILE_SAVE) 
 98          self.gui.Bind(wx.EVT_MENU, self.gui.action_state_save_as, id=self.MENU_FILE_SAVE_AS) 
 99          self.gui.Bind(wx.EVT_MENU, self.gui.action_export_bmrb, id=self.MENU_FILE_EXPORT_BMRB) 
100          self.gui.Bind(wx.EVT_MENU, self.gui.exit_gui, id=self.MENU_FILE_EXIT) 
101   
102          # The 'View' menu entries. 
103          menu = wx.Menu() 
104          menu.AppendItem(build_menu_item(menu, id=self.MENU_VIEW_CONTROLLER, text="&Controller\tCtrl+Z", icon=fetch_icon('oxygen.apps.preferences-system-performance', "16x16"))) 
105          menu.AppendItem(build_menu_item(menu, id=self.MENU_VIEW_SPIN_VIEW, text="&Spin viewer\tCtrl+T", icon=fetch_icon('relax.spin', "16x16"))) 
106          menu.AppendItem(build_menu_item(menu, id=self.MENU_VIEW_RESULTS, text="&Results viewer\tCtrl+R", icon=fetch_icon('oxygen.actions.view-statistics', "16x16"))) 
107          menu.AppendItem(build_menu_item(menu, id=self.MENU_VIEW_PIPE_EDIT, text="&Data pipe editor\tCtrl+D", icon=fetch_icon('relax.pipe', "16x16"))) 
108          menu.AppendItem(build_menu_item(menu, id=self.MENU_VIEW_PROMPT, text="relax &prompt\tCtrl+P", icon=fetch_icon('oxygen.mimetypes.application-x-executable-script', "16x16"))) 
109          self.menubar.Append(menu, "&View") 
110   
111          # The 'View' actions. 
112          self.gui.Bind(wx.EVT_MENU, self.gui.show_controller, id=self.MENU_VIEW_CONTROLLER) 
113          self.gui.Bind(wx.EVT_MENU, self.gui.show_prompt, id=self.MENU_VIEW_PROMPT) 
114          self.gui.Bind(wx.EVT_MENU, self.gui.show_tree, id=self.MENU_VIEW_SPIN_VIEW) 
115          self.gui.Bind(wx.EVT_MENU, self.gui.show_results_viewer, id=self.MENU_VIEW_RESULTS) 
116          self.gui.Bind(wx.EVT_MENU, self.gui.show_pipe_editor, id=self.MENU_VIEW_PIPE_EDIT) 
117   
118          # The auto generated 'User functions' menu entries. 
119          self.menu_uf_ids = build_uf_menus(parent=self.gui, menubar=self.menubar) 
120   
121          # The 'Tools' menu entries. 
122          menu = wx.Menu() 
123          menu.AppendItem(build_menu_item(menu, id=self.MENU_TOOLS_FORMAT, text="&Free file format settings", icon=fetch_icon('oxygen.actions.document-properties', "16x16"))) 
124          menu.AppendItem(build_menu_item(menu, id=self.MENU_TOOLS_SYS_INFO, text="System &information", icon=fetch_icon('oxygen.actions.help-about', "16x16"))) 
125   
126          # The 'Tools->Test suite" sub-menu. 
127          test_suite_item = build_menu_item(menu, id=self.MENU_TOOLS_TEST_SUITE, text="&Test suite", icon=fetch_icon('oxygen.mimetypes.application-x-desktop', "16x16")) 
128          sub_menu = wx.Menu() 
129          test_suite_item.SetSubMenu(sub_menu) 
130          sub_menu.AppendItem(build_menu_item(sub_menu, id=self.MENU_TOOLS_TEST_SUITE_ALL, text="&Full test suite", icon=fetch_icon('oxygen.mimetypes.application-x-desktop', "16x16"))) 
131          sub_menu.AppendSeparator() 
132          sub_menu.AppendItem(build_menu_item(sub_menu, id=self.MENU_TOOLS_TEST_SUITE_SYS, text="&System tests", icon=fetch_icon('oxygen.mimetypes.application-x-desktop', "16x16"))) 
133          sub_menu.AppendItem(build_menu_item(sub_menu, id=self.MENU_TOOLS_TEST_SUITE_UNIT, text="&Unit tests", icon=fetch_icon('oxygen.mimetypes.application-x-desktop', "16x16"))) 
134          sub_menu.AppendItem(build_menu_item(sub_menu, id=self.MENU_TOOLS_TEST_SUITE_GUI, text="&GUI tests", icon=fetch_icon('oxygen.mimetypes.application-x-desktop', "16x16"))) 
135          menu.AppendItem(test_suite_item) 
136          self.menubar.Append(menu, "&Tools") 
137   
138          # The 'Tools' menu actions. 
139          self.gui.Bind(wx.EVT_MENU, self.gui.free_file_format_settings, id=self.MENU_TOOLS_FORMAT) 
140          self.gui.Bind(wx.EVT_MENU, self._sys_info, id=self.MENU_TOOLS_SYS_INFO) 
141          self.gui.Bind(wx.EVT_MENU, self.gui.run_test_suite, id=self.MENU_TOOLS_TEST_SUITE_ALL) 
142          self.gui.Bind(wx.EVT_MENU, self.gui.run_test_suite_sys, id=self.MENU_TOOLS_TEST_SUITE_SYS) 
143          self.gui.Bind(wx.EVT_MENU, self.gui.run_test_suite_unit, id=self.MENU_TOOLS_TEST_SUITE_UNIT) 
144          self.gui.Bind(wx.EVT_MENU, self.gui.run_test_suite_gui, id=self.MENU_TOOLS_TEST_SUITE_GUI) 
145   
146          # The 'Help' menu entries. 
147          menu = wx.Menu() 
148          menu.AppendItem(build_menu_item(menu, id=self.MENU_HELP_MANUAL, text="relax user &manual\tF1", icon=fetch_icon('oxygen.mimetypes.application-pdf', "16x16"))) 
149          menu.AppendSeparator() 
150          menu.AppendItem(build_menu_item(menu, id=self.MENU_HELP_MAIL, text="Mailing list &contact (relax-users@gna.org)", icon=fetch_icon('oxygen.actions.mail-mark-unread-new', "16x16"))) 
151          menu.AppendItem(build_menu_item(menu, id=self.MENU_HELP_REFS, text="&References", icon=fetch_icon('oxygen.actions.flag-blue', "16x16"))) 
152          menu.AppendSeparator() 
153          menu.AppendItem(build_menu_item(menu, id=self.MENU_HELP_GPL, text="&Licence", icon=fetch_icon('relax.gnu-head-mini', "16x16"))) 
154          menu.AppendSeparator() 
155          menu.AppendItem(build_menu_item(menu, id=self.MENU_HELP_ABOUT, text="About rela&x", icon=fetch_icon("relax.relax"))) 
156          self.menubar.Append(menu, "&Help") 
157   
158          # The 'Help' menu actions. 
159          self.gui.Bind(wx.EVT_MENU, self.gui.relax_manual, id=self.MENU_HELP_MANUAL) 
160          self.gui.Bind(wx.EVT_MENU, self.gui.contact_relax, id=self.MENU_HELP_MAIL) 
161          self.gui.Bind(wx.EVT_MENU, self.gui.references, id=self.MENU_HELP_REFS) 
162          self.gui.Bind(wx.EVT_MENU, self._licence, id=self.MENU_HELP_GPL) 
163          self.gui.Bind(wx.EVT_MENU, self.gui.about_relax, id=self.MENU_HELP_ABOUT) 
164   
165          # Add the menu bar GUI item to the main frame. 
166          if status.show_gui: 
167              self.gui.SetMenuBar(self.menubar) 
168   
169          # Menu update. 
170          self.gui.Bind(wx.EVT_MENU_OPEN, self.update_menus) 
171   
172   
173 -    def _create_menu(self, menu, entries): 
174          """Build the menu.""" 
175   
176          # Loop over the menu entries. 
177          for item in entries: 
178              # Build the menu entry. 
179              menu_item = build_menu_item(menu, id=item[0], text=item[1], icon=item[2]) 
180   
181              # A sub-menu. 
182              if len(item[4]): 
183                  # The sub-menu. 
184                  sub_menu = wx.Menu() 
185   
186                  # Loop over the sub-menus. 
187                  for sub_item in item[4]: 
188                      # Build the menu entry. 
189                      sub_menu_item = build_menu_item(sub_menu, id=sub_item[0], text=sub_item[1], icon=sub_item[2]) 
190                      sub_menu.AppendItem(sub_menu_item) 
191   
192                      # The menu actions. 
193                      self.gui.Bind(wx.EVT_MENU, sub_item[3], id=sub_item[0]) 
194   
195                  # Append the sub-menu. 
196                  menu_item.SetSubMenu(sub_menu) 
197   
198              # A normal menu item. 
199              else: 
200                  # The menu actions. 
201                  self.gui.Bind(wx.EVT_MENU, item[3], id=item[0]) 
202   
203              # Append the menu item. 
204              menu.AppendItem(menu_item) 
205   
206   
207 -    def _licence(self, event): 
208          """Show the GPL licence. 
209   
210          @param event:   The wx event. 
211          @type event:    wx event 
212          """ 
213   
214          # Print the GPL to STDOUT. 
215          file = open('docs/COPYING') 
216          for line in file.readlines(): 
217              sys.stdout.write(line) 
218   
219          # Show the relax controller. 
220          self.gui.show_controller(event) 
221   
222   
223 -    def _sys_info(self, event): 
224          """Show the full system information using the sys_info user function. 
225   
226          @param event:   The wx event. 
227          @type event:    wx event 
228          """ 
229   
230          # Launch the user function. 
231          uf_store['sys_info']() 
232   
233   
234 -    def update_menus(self, event): 
235          """Update the menus dependent on the relax state. 
236   
237          @param event:   The wx event. 
238          @type event:    wx event 
239          """ 
240   
241          # The status object. 
242          status = Status() 
243   
244          # Flag for enabling or disabling the menu entries. 
245          enable = False 
246          if not status.exec_lock.locked(): 
247              enable = True 
248   
249          # The file menu entries. 
250          self.menubar.Enable(self.MENU_FILE_NEW, enable) 
251          self.menubar.Enable(self.MENU_FILE_CLOSE, enable) 
252          self.menubar.Enable(self.MENU_FILE_CLOSE_ALL, enable) 
253          self.menubar.Enable(self.MENU_FILE_OPEN, enable) 
254          self.menubar.Enable(self.MENU_FILE_SAVE, enable) 
255          self.menubar.Enable(self.MENU_FILE_SAVE_AS, enable) 
256   
257          # The view menu entries. 
258          self.menubar.Enable(self.MENU_VIEW_PROMPT, enable) 
259   
260          # Loop over the user function menus. 
261          for id in self.menu_uf_ids: 
262              # Loop over the user function menu items. 
263              menu = self.menubar.GetMenu(id) 
264              for item in menu.GetMenuItems(): 
265                  # Enable/disable. 
266                  item.Enable(enable) 
267   
268                  # Sub-menu. 
269                  submenu = item.GetSubMenu() 
270                  if submenu: 
271                      for subitem in submenu.GetMenuItems(): 
272                          subitem.Enable(enable) 
273