1 files changed, 87 insertions, 0 deletions
diff --git a/templates/annotated/systray1.py b/templates/annotated/systray1.py
new file mode 100644
index 0000000..99b7f03
--- /dev/null
+++ b/templates/annotated/systray1.py
@@ -0,0 +1,87 @@
+"""
+A basic system tray application - you can combine this with code from
+menuapp2.py or menuapp3.py to quickly build a full-blown application
+framework.
+"""
+
+"""
+Copyright 2003 Jim Bublitz
+
+Terms and Conditions
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to
+deal in the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
+IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+Except as contained in this notice, the name of the copyright holder shall
+not be used in advertising or otherwise to promote the sale, use or other
+dealings in this Software without prior written authorization from the
+copyright holder.
+"""
+
+import sys
+
+from qt import QLabel, QWidget, SIGNAL
+from kdecore import KApplication, KIcon, KIconLoader
+from kdeui import KMainWindow, KSystemTray
+
+# This template uses KMainWindow as the main window widget
+# It solves the problem described in systray.py by using
+# a flag to control the return value from queryClose - if
+# :quit" is signalled from anywhere EXCEPT the system tray
+# icon's menu, self.exitFlag == False, and as the return
+# value for queryClose, it stops the application from shutting
+# down; if self.exitFlag is True, the application shuts down
+
+class MainWin (KMainWindow):
+    def __init__ (self, *args):
+        apply (KMainWindow.__init__, (self,) + args)
+
+        self.exitFlag = False
+
+        icons = KIconLoader ()
+
+        # KSystemTray hides or shows its parent when the system tray icon is clicked
+        self.systray = KSystemTray (self)
+        self.systray.setPixmap (icons.loadIcon("stop", KIcon.Desktop))
+        self.systray.connect (self.systray, SIGNAL ("quitSelected ()"), self.slotQuitSelected)
+        self.systray.show ()
+
+    # Controls whether or not the application really exits
+    def queryClose (self):
+        self.hide ()
+        return self.exitFlag
+
+    # Receives the signal emitted when the user selects Quit from the
+    # system tray icon's menu
+    def slotQuitSelected (self):
+        self.exitFlag = True
+        KApplication.kApplication ().quit ()
+
+#-------------------- main ------------------------------------------------
+
+# The usual stuff - you can also use the KAboutData/KCmdLineArgs version
+# for program startup used in other templates - the KApplication constructor
+# used here may be obsoleted eventually
+appName = "template"
+app = KApplication (sys.argv, appName)
+mainWindow = MainWin (None, "main window")
+
+mainWindow.show()
+app.exec_loop()
+
+