Changeset 227:50c3ae93007d for src/mlx/gui

Timestamp:

06/05/12 18:20:01 (12 years ago)

Author:

István Váradi <ivaradi@…>

Branch:

default

Phase:

public

Message:

Added a Help menu with the manual and the about dialog

Location:

src/mlx/gui

Files:

• common.py (modified) (4 diffs)
• gui.py (modified) (7 diffs)

src/mlx/gui/common.py

@@ -60 +60 @@
     WEIGHT_BOLD = pango.WEIGHT_BOLD
 
+    pixbuf_new_from_file = gdk.pixbuf_new_from_file
+
     def text2unicode(text):
         """Convert the given text, returned by a Gtk widget, to Unicode."""
@@ -67 +69 @@
     pygobject = True
     from gi.repository import Gdk as gdk
+    from gi.repository import GdkPixbuf as gdkPixbuf
     from gi.repository import Gtk as gtk
     from gi.repository import GObject as gobject
@@ -109 +112 @@
     WEIGHT_BOLD = pango.Weight.BOLD
 
+    pixbuf_new_from_file = gdkPixbuf.Pixbuf.new_from_file
+
     import codecs
     _utf8Decoder = codecs.getdecoder("utf-8")
@@ -208 +213 @@
 #------------------------------------------------------------------------------
 
-WINDOW_TITLE_BASE = "MAVA Logger X " + _const.VERSION
+PROGRAM_NAME = "MAVA Logger X"
+
+WINDOW_TITLE_BASE = PROGRAM_NAME + " " + _const.VERSION
 
 #------------------------------------------------------------------------------

src/mlx/gui/gui.py

@@ -1 +1 @@
 # The main file for the GUI
+# -*- coding: utf-8 -*-
 
 from statusicon import StatusIcon
@@ -21 +22 @@
 import mlx.web as web
 import mlx.singleton as singleton
-from  mlx.i18n import xstr
+from  mlx.i18n import xstr, getLanguage
 from mlx.pirep import PIREP
 
@@ -28 +29 @@
 import sys
 import datetime
+import webbrowser
 
 #------------------------------------------------------------------------------
@@ -33 +35 @@
 class GUI(fs.ConnectionListener):
     """The main GUI class."""
+    _authors = [ ("Váradi", "István", "prog_test"),
+                 ("Galyassy", "Tamás", "negotiation"),
+                 ("Petrovszki", "Gábor", "test"),
+                 ("Zsebényi-Loksa", "Gergely", "test"),
+                 ("Kurják", "Ákos", "test"),
+                 ("Radó", "Iván", "test") ]
+
     def __init__(self, programDirectory, config):
         """Construct the GUI."""
@@ -158 +167 @@
         self._pilotHotkeyIndex = None
         self._checklistHotkeyIndex = None
+
+        self._aboutDialog = None
 
     @property
@@ -872 +883 @@
         showDebugMenuItem.connect("toggled", self._toggleDebugLog)
         viewMenu.append(showDebugMenuItem)
+
+        helpMenuItem = gtk.MenuItem(xstr("menu_help"))
+        helpMenu = gtk.Menu()
+        helpMenuItem.set_submenu(helpMenu)
+        menuBar.append(helpMenuItem)
+
+        manualMenuItem = gtk.ImageMenuItem(gtk.STOCK_HELP)
+        manualMenuItem.set_use_stock(True)
+        manualMenuItem.set_label(xstr("menu_help_manual"))
+        manualMenuItem.add_accelerator("activate", accelGroup,
+                                       ord(xstr("menu_help_manual_key")),
+                                       CONTROL_MASK, ACCEL_VISIBLE)
+        manualMenuItem.connect("activate", self._showManual)
+        helpMenu.append(manualMenuItem)
+
+        helpMenu.append(gtk.SeparatorMenuItem())
+        
+        aboutMenuItem = gtk.ImageMenuItem(gtk.STOCK_ABOUT)
+        aboutMenuItem.set_use_stock(True)
+        aboutMenuItem.set_label(xstr("menu_help_about"))
+        aboutMenuItem.add_accelerator("activate", accelGroup,
+                                      ord(xstr("menu_help_about_key")),
+                                      CONTROL_MASK, ACCEL_VISIBLE)
+        aboutMenuItem.connect("activate", self._showAbout)
+        helpMenu.append(aboutMenuItem)
 
         return menuBar
@@ -1232 +1268 @@
                 else:
                     print "gui.GUI._handleHotkeys: unhandled hotkey index:", index
+
+    def _showManual(self, menuitem):
+        """Show the user's manual."""
+        webbrowser.open(url ="file://" +
+                        os.path.join(self._programDirectory, "doc", "manual",
+                                     getLanguage(), "index.html"),
+                        new = 1)
+
+    def _showAbout(self, menuitem):
+        """Show the about dialog."""
+        dialog = self._getAboutDialog()
+        dialog.show_all()
+        dialog.run()
+        dialog.hide()
+
+    def _getAboutDialog(self):
+        """Get the about dialog.
+
+        If it does not exist yet, it will be created."""
+        if self._aboutDialog is None:
+            self._aboutDialog = dialog = gtk.AboutDialog()
+            dialog.set_transient_for(self._mainWindow)
+            dialog.set_modal(True)
+            
+            logoPath = os.path.join(self._programDirectory, "logo.png")
+            logo = pixbuf_new_from_file(logoPath)
+            dialog.set_logo(logo)
+                                
+            dialog.set_program_name(PROGRAM_NAME)
+            dialog.set_version(const.VERSION)
+            dialog.set_copyright("(c) 2012 by István Váradi")
+
+            isHungarian = getLanguage()=="hu"
+            authors = []
+            for (familyName, firstName, role) in GUI._authors:
+                authors.append("%s %s (%s)" % \
+                               (familyName if isHungarian else firstName,
+                                firstName if isHungarian else familyName,
+                                xstr("about_role_" + role)))            
+            dialog.set_authors(authors)
+
+            dialog.set_license(xstr("about_license"))
+
+        return self._aboutDialog