svcgrp_python.h
00001 /*************************************************************************** 00002 * Copyright (C) 2004 Luke Kenneth Casson Leighton <lkcl@lkcl.net> * 00003 * * 00004 * This program is free software; you can redistribute it and/or modify * 00005 * it under the terms of the GNU General Public License as published by * 00006 * the Free Software Foundation; either version 2 of the License, or * 00007 * (at your option) any later version. * 00008 ***************************************************************************/ 00009 00010 #ifndef SVC_GRPS_PYTHON_H 00011 #define SVC_GRPS_PYTHON_H 00012 00013 #include <Python.h> 00014 00015 //****p* Misc/getServiceGroups 00016 // 00017 // SYNOPSIS 00018 // list getServiceGroups(widget, path) 00019 // DESCRIPTION 00020 // This function returns a list of services and service groups 00021 // that are in the user's KDE Menu. It is not a recursive 00022 // function, so if there are submenus (service groups) in the 00023 // returned results, you must call getServiceGroups with the 00024 // path of the submenu in order to obtain the information in 00025 // that submenu. 00026 // The return result is complex: it's a list of tuples. 00027 // The tuple contains two elements - a 1 if the second element 00028 // is a service, and a 0 if it's a service group. 00029 // The second element is a dictionary, with keys (if they exist) 00030 // of caption, comment, icon, and relpath if it's a service group, 00031 // and keys (if they exist) of exec, menuid, name, path, icon, 00032 // library, comment, type and genericname. 00033 // To fully understand the return results of this function, 00034 // it is thoroughly recommended // that you look up the 00035 // KDE documentation on KServiceGroup and KService. 00036 // ARGUMENTS 00037 // * long widget -- karamba 00038 // * string path -- path to the Service Group you wish to retrieve 00039 // RETURN VALUE 00040 // List of Dictionaries of services and service groups 00041 //*** 00042 PyObject* py_get_service_groups(PyObject *self, PyObject *args); 00043 00044 #endif // SVC_GRPS_PYTHON_H