libmmanager/mm-application.h

   1 /* MManager - a Desktop wide manager for multimedia applications.
   2  *
   3  * Copyright (C) 2008 Cosimo Cecchi <cosimoc@gnome.org>
   4  *
   5  * This library is free software; you can redistribute it and/or
   6  * modify it under the terms of the GNU Lesser General Public
   7  * License as published by the Free Software Foundation; either
   8  * version 2 of the License, or (at your option) any later version.
   9  *
  10  * This library is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13  * Lesser General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU Lesser General Public
  16  * License along with this library; if not, write to the
  17  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  18  * Boston, MA 02111-1307, USA.
  19  */
  20
  21 #ifndef __MM_APPLICATION_H__
  22 #define __MM_APPLICATION_H__
  23
  24 #include <glib.h>
  25 #include <gio/gdesktopappinfo.h>
  26 #include "mm-types.h"
  27
  28 #define MM_TYPE_APPLICATION            (mm_application_get_type())
  29 #define MM_APPLICATION(obj)            (G_TYPE_CHECK_INSTANCE_CAST ((obj),\
  30                                         MM_TYPE_APPLICATION, MMApplication))
  31 #define MM_APPLICATION_CLASS(klass)    (G_TYPE_CHECK_CLASS_CAST ((klass),\
  32                                         MM_TYPE_APPLICATION, MMApplicationClass))
  33 #define MM_IS_APPLICATION(obj)         (G_TYPE_CHECK_INSTANCE_TYPE ((obj),\
  34                                         MM_TYPE_APPLICATION))
  35 #define MM_IS_APPLICATION_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((obj),\
  36                                         MM_TYPE_APPLICATION))
  37 #define MM_APPLICATION_GET_CLASS(obj)  (G_TYPE_INSTANCE_GET_CLASS((obj),\
  38                                         MM_TYPE_APPLICATION, MMApplicationClass))
  39
  40 /**
  41  * MMApplication:
  42  *
  43  * An object which identifies an application inside the library. This object
  44  * has two implementations: #MMSoApplication and #MMDBusApplication, which
  45  * allow a library client to implement the object either using #MMModule
  46  * or DBus facilities.
  47  */
  48
  49 typedef struct _MMApplication        MMApplication;
  50 typedef struct _MMApplicationDetails MMApplicationDetails;
  51 typedef struct _MMApplicationClass   MMApplicationClass;
  52
  53 struct _MMApplication {
  54   GObject parent_object;
  55   MMApplicationDetails *details;
  56 };
  57
  58 /**
  59  * MMApplicationClass:
  60  * @parent_class: the parent class.
  61  * @get_categories: gets all the categories inside the application.
  62  *
  63  * The class of a #MMApplication object.
  64  */
  65
  66 struct _MMApplicationClass {
  67   GObjectClass parent_class;
  68
  69   GList *  (* get_categories) (MMApplication  *application,
  70                                GError        **error);
  71 };
  72
  73 GType                 mm_application_get_type          (void);
  74
  75 GAppInfo*             mm_application_get_app_info      (MMApplication     *application);
  76 const char *          mm_application_get_id            (MMApplication     *application);
  77 void                  mm_application_set_attributes    (MMApplication     *application,
  78                                                         const char        *desktop_id,
  79                                                         MMApplicationType  supported_type,
  80                                                         const char        *id);
  81 GList*                mm_application_get_categories    (MMApplication     *application,
  82                                                         GError           **error);
  83
  84 #endif /* __MM_APPLICATION_H__ */