1 files changed, 44 insertions, 0 deletions
diff --git a/superkaramba/src/svcgrp_python.h b/superkaramba/src/svcgrp_python.h
new file mode 100644
index 0000000..e8d4e4b
--- /dev/null
+++ b/superkaramba/src/svcgrp_python.h
@@ -0,0 +1,44 @@
+/***************************************************************************
+ * Copyright (C) 2004 Luke Kenneth Casson Leighton <lkcl@lkcl.net>         * 
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ ***************************************************************************/
+
+#ifndef SVC_GRPS_PYTHON_H
+#define SVC_GRPS_PYTHON_H
+
+#include <Python.h>
+
+//****p* Misc/getServiceGroups
+//
+// SYNOPSIS
+//   list getServiceGroups(widget, path)
+// DESCRIPTION
+//  This function returns a list of services and service groups
+//  that are in the user's KDE Menu.  It is not a recursive
+//  function, so if there are submenus (service groups) in the
+//  returned results, you must call getServiceGroups with the
+//  path of the submenu in order to obtain the information in
+//  that submenu.
+//  The return result is complex: it's a list of tuples.
+//  The tuple contains two elements - a 1 if the second element
+//  is a service, and a 0 if it's a service group.
+//  The second element is a dictionary, with keys (if they exist)
+//  of caption, comment, icon, and relpath if it's a service group,
+//  and keys (if they exist) of exec, menuid, name, path, icon,
+//  library, comment, type and genericname.
+//  To fully understand the return results of this function,
+//  it is thoroughly recommended //  that you look up the
+//  KDE documentation on KServiceGroup and KService.
+// ARGUMENTS
+//   * long widget -- karamba
+//   * string path -- path to the Service Group you wish to retrieve
+// RETURN VALUE
+//   List of Dictionaries of services and service groups
+//***
+PyObject* py_get_service_groups(PyObject *self, PyObject *args);
+
+#endif // SVC_GRPS_PYTHON_H