Observe volume keys on Symbian. Add minimal documentation to headers.

[dorian] / widgets / adopterwindow.h

diff --git a/widgets/adopterwindow.h b/widgets/adopterwindow.h
index ba486b1..f09a05b 100644 (file)
--- a/widgets/adopterwindow.h
+++ b/widgets/adopterwindow.h
@@ -4,6 +4,10 @@
 #include <QMainWindow>
 #include <QList>
 
+#ifdef Q_OS_SYMBIAN
+#   include "mediakeysobserver.h"
+#endif
+
 class QWidget;
 class QToolBar;
 class QAction;
@@ -17,13 +21,19 @@ class AdopterWindow: public QMainWindow
     Q_OBJECT
 public:
     explicit AdopterWindow(QWidget *parent = 0);
+
+    /* If true, zoom (volume) keys will generate Key_F7 and Key_F8 events. */
     void grabZoomKeys(bool grab);
+
+    /** Adopt children "main" and "others". */
     void takeChildren(QWidget *main, const QList<QWidget *> &others);
+
+    /** Release current children (adopted in @see takeChildren). */
     void leaveChildren();
 
     /**
      * Add action that is visible on the tool bar (except on Symbian, where
-     * it is visible on the Options menu.
+     * it is visible on the Options menu).
      */
     QAction *addToolBarAction(QObject *receiver, const char *slot,
                               const QString &iconName, const QString &text);
@@ -36,7 +46,10 @@ public:
 
 signals:
 
-public slots:
+protected slots:
+#ifdef Q_OS_SYMBIAN
+    void onMediaKeysPressed(MediaKeysObserver::MediaKeys key);
+#endif
 
 protected:
     void showEvent(QShowEvent *e);