libpurple/theme.h

   1 /* purple
   2  *
   3  * Purple is the legal property of its developers, whose names are too numerous
   4  * to list here.  Please refer to the COPYRIGHT file distributed with this
   5  * source distribution.
   6  *
   7  * This program is free software; you can redistribute it and/or modify
   8  * it under the terms of the GNU General Public License as published by
   9  * the Free Software Foundation; either version 2 of the License, or
  10  * (at your option) any later version.
  11  *
  12  * This program is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  * GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License
  18  * along with this program; if not, write to the Free Software
  19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02111-1301  USA
  20  */
  21
  22 #ifndef PURPLE_THEME_H
  23 #define PURPLE_THEME_H
  24 /**
  25  * SECTION:theme
  26  * @section_id: libpurple-theme
  27  * @short_description: <filename>theme.h</filename>
  28  * @title: Theme Abstact Class
  29  */
  30
  31 #include <glib.h>
  32 #include <glib-object.h>
  33
  34 #define PURPLE_TYPE_THEME  purple_theme_get_type()
  35
  36 struct _PurpleThemeClass
  37 {
  38         GObjectClass parent_class;
  39
  40         /*< private >*/
  41         void (*purple_reserved1)(void);
  42         void (*purple_reserved2)(void);
  43         void (*purple_reserved3)(void);
  44         void (*purple_reserved4)(void);
  45 };
  46
  47 /**************************************************************************/
  48 /* Purple Theme API                                                       */
  49 /**************************************************************************/
  50 G_BEGIN_DECLS
  51
  52 /**
  53  * purple_theme_get_type:
  54  *
  55  * Returns: The #GType for a theme.
  56  */
  57 G_DECLARE_DERIVABLE_TYPE(PurpleTheme, purple_theme, PURPLE, THEME, GObject)
  58
  59 /**
  60  * purple_theme_get_name:
  61  * @theme:  The purple theme.
  62  *
  63  * Returns the name of the PurpleTheme object.
  64  *
  65  * Returns: The string representing the name of the theme.
  66  */
  67 const gchar *purple_theme_get_name(PurpleTheme *theme);
  68
  69 /**
  70  * purple_theme_set_name:
  71  * @theme: The purple theme.
  72  * @name:  The name of the PurpleTheme object.
  73  *
  74  * Sets the name of the PurpleTheme object.
  75  */
  76 void purple_theme_set_name(PurpleTheme *theme, const gchar *name);
  77
  78 /**
  79  * purple_theme_get_description:
  80  * @theme:  The purple theme.
  81  *
  82  * Returns the description of the PurpleTheme object.
  83  *
  84  * Returns: A short description of the theme.
  85  */
  86 const gchar *purple_theme_get_description(PurpleTheme *theme);
  87
  88 /**
  89  * purple_theme_set_description:
  90  * @theme:  The purple theme.
  91  * @description: The description of the PurpleTheme object.
  92  *
  93  * Sets the description of the PurpleTheme object.
  94  */
  95 void purple_theme_set_description(PurpleTheme *theme, const gchar *description);
  96
  97 /**
  98  * purple_theme_get_author:
  99  * @theme:  The purple theme.
 100  *
 101  * Returns the author of the PurpleTheme object.
 102  *
 103  * Returns: The author of the theme.
 104  */
 105 const gchar *purple_theme_get_author(PurpleTheme *theme);
 106
 107 /**
 108  * purple_theme_set_author:
 109  * @theme:  The purple theme.
 110  * @author: The author of the PurpleTheme object.
 111  *
 112  * Sets the author of the PurpleTheme object.
 113  */
 114 void purple_theme_set_author(PurpleTheme *theme, const gchar *author);
 115
 116 /**
 117  * purple_theme_get_type_string:
 118  * @theme:  The purple theme.
 119  *
 120  * Returns the type (string) of the PurpleTheme object.
 121  *
 122  * Returns: The string representing the type.
 123  */
 124 const gchar *purple_theme_get_type_string(PurpleTheme *theme);
 125
 126 /**
 127  * purple_theme_get_dir:
 128  * @theme:  The purple theme.
 129  *
 130  * Returns the directory of the PurpleTheme object.
 131  *
 132  * Returns: The string representing the theme directory.
 133  */
 134 const gchar *purple_theme_get_dir(PurpleTheme *theme);
 135
 136 /**
 137  * purple_theme_set_dir:
 138  * @theme:  The purple theme.
 139  * @dir:    The directory of the PurpleTheme object.
 140  *
 141  * Sets the directory of the PurpleTheme object.
 142  */
 143 void purple_theme_set_dir(PurpleTheme *theme, const gchar *dir);
 144
 145 /**
 146  * purple_theme_get_image:
 147  * @theme:  The purple theme.
 148  *
 149  * Returns the image preview of the PurpleTheme object.
 150  *
 151  * Returns: The image preview of the PurpleTheme object.
 152  */
 153 const gchar *purple_theme_get_image(PurpleTheme *theme);
 154
 155 /**
 156  * purple_theme_get_image_full:
 157  * @theme:  The purple theme.
 158  *
 159  * Returns the image preview and directory of the PurpleTheme object.
 160  *
 161  * Returns: The image preview of the PurpleTheme object.
 162  */
 163 gchar *purple_theme_get_image_full(PurpleTheme *theme);
 164
 165 /**
 166  * purple_theme_set_image:
 167  * @theme:       The purple theme.
 168  * @img:    The image preview of the PurpleTheme object.
 169  *
 170  * Sets the directory of the PurpleTheme object.
 171  */
 172 void purple_theme_set_image(PurpleTheme *theme, const gchar *img);
 173
 174 G_END_DECLS
 175
 176 #endif /* PURPLE_THEME_H */