Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdelibs@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 99 insertions, 0 deletions

diff --git a/kdeui/kpanelappmenu.h b/kdeui/kpanelappmenu.h
new file mode 100644
index 000000000..2cb9adc1f
--- /dev/null
+++ b/kdeui/kpanelappmenu.h
@@ -0,0 +1,99 @@
+/*
+
+(C) Daniel M. Duley <mosfet@kde.org>
+(C) Matthias Ettrich <ettrich@kde.org>
+
+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
+AUTHORS 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.
+
+*/
+
+#ifndef __PANELAPPMENU_H
+#define __PANELAPPMENU_H "$Id$"
+
+#include <dcopobject.h>
+
+
+/**
+ * DCop client menu class for the Kicker panel that will insert a submenu into
+ * the %KDE menu.
+ *
+ * @author Daniel M. Duley <mosfet@kde.org>
+ */
+class KDEUI_EXPORT KPanelAppMenu : public QObject, public DCOPObject
+{
+    Q_OBJECT
+public:
+    /**
+     * Constructs a new menu with the given title.
+     */
+    KPanelAppMenu(const QString &title, QObject *parent = 0, const char *name = 0 );
+    /**
+     * Same as above, but with an icon for the submenu item.
+     */
+    KPanelAppMenu(const QPixmap &icon, const QString &title, QObject *parent,
+              const char *name);
+    /**
+     * Constructs a new (sub)menu with a given id.
+     */
+    KPanelAppMenu(QObject *parent, const char *name);
+
+    /**
+     * Make sure you actually destroy this thing or the menu will never go
+     * away until this application quits or Kicker restarts ;-)
+     */
+    ~KPanelAppMenu();
+
+    /**
+     * Inserts an item into the menu.
+     */
+    int insertItem(const QString &text, int id = -1);
+    /**
+     * Inserts an item with a icon. The icon name must be a full path.
+     */
+    int insertItem(const QPixmap &icon, const QString &text, int id = -1 );
+    /**
+     * Inserts a sub menu with a icon. The icon name must be a full path.
+     */
+    KPanelAppMenu *insertMenu(const QPixmap &icon, const QString &text, int id=-1);
+
+    /**
+     * Clears the menu.
+     */
+    void clear();
+
+    /**
+     * @internal
+     */
+    bool process(const QCString &fun, const QByteArray &data,
+		 QCString &replyType, QByteArray &replyData);
+
+signals:
+    /**
+     * Emitted when the user selects an item from the Kicker menu.
+     */
+    void activated(int id);
+
+protected:
+    void init(const QPixmap &icon, const QString &title);
+
+private:
+    QCString realObjId;
+};
+
+
+#endif