* Pidgin is the legal property of its developers, whose names are too numerous * to list here. Please refer to the COPYRIGHT file distributed with this * 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. * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA #ifndef PIDGIN_BLIST_THEME_H #define PIDGIN_BLIST_THEME_H * @section_id: pidgin-gtkblist-theme * @short_description: <filename>gtkblist-theme.h</filename> * @title: Buddy List Theme API #define PIDGIN_TYPE_BLIST_THEME (pidgin_blist_theme_get_type ()) #define PIDGIN_TYPE_THEME_FONT (pidgin_theme_font_get_type()) #define PIDGIN_TYPE_BLIST_LAYOUT (pidgin_blist_layout_get_type()) typedef struct _PidginThemeFont PidginThemeFont; typedef struct _PidginBlistLayout PidginBlistLayout; struct _PidginBlistLayout /**************************************************************************/ /* PidginThemeFont API */ /**************************************************************************/ * pidgin_theme_font_get_type: * Returns: The #GType for the #PidginThemeFont boxed structure. GType pidgin_theme_font_get_type(void); * @color: The color of the font * Create a new PidginThemeFont. * Returns: A newly created PidginThemeFont PidginThemeFont *pidgin_theme_font_new(const gchar *face, GdkRGBA *color); * pidgin_theme_font_free: * Frees a font and color pair void pidgin_theme_font_free(PidginThemeFont *font); * pidgin_theme_font_set_font_face: * @font: The PidginThemeFont * Set the font-face of a PidginThemeFont. void pidgin_theme_font_set_font_face(PidginThemeFont *font, const gchar *face); * pidgin_theme_font_set_color: * @font: The PidginThemeFont * Set the color of a PidginThemeFont. void pidgin_theme_font_set_color(PidginThemeFont *font, const GdkRGBA *color); * pidgin_theme_font_get_font_face: * @font: The PidginThemeFont * Get the font-face of a PidginThemeFont. * Returns: The font-face, or NULL if none is set. const gchar * pidgin_theme_font_get_font_face(PidginThemeFont *font); * pidgin_theme_font_get_color: * @font: The PidginThemeFont * Get the color of a PidginThemeFont as a GdkRGBA object. * Returns: The color, or NULL if none is set. const GdkRGBA *pidgin_theme_font_get_color(PidginThemeFont *font); * pidgin_theme_font_get_color_describe: * @font: The PidginThemeFont * Get the color of a PidginThemeFont. * Returns: The color, or NULL if none is set. const gchar * pidgin_theme_font_get_color_describe(PidginThemeFont *font); /**************************************************************************/ /* Purple Buddy List Theme API */ /**************************************************************************/ * pidgin_blist_theme_get_type: * Returns: The #GType for a blist theme. G_DECLARE_FINAL_TYPE(PidginBlistTheme, pidgin_blist_theme, PIDGIN, BLIST_THEME, * pidgin_blist_layout_get_type: * Returns: The #GType for the #PidginBlistLayout boxed structure. GType pidgin_blist_layout_get_type(void); * pidgin_blist_theme_get_background_color: * @theme: The PidginBlist theme. * Returns the background color of the buddy list. GdkRGBA *pidgin_blist_theme_get_background_color(PidginBlistTheme *theme); * pidgin_blist_theme_get_opacity: * @theme: The PidginBlist theme. * Returns the opacity of the buddy list window * (0.0 or clear to 1.0 fully opaque). gdouble pidgin_blist_theme_get_opacity(PidginBlistTheme *theme); * pidgin_blist_theme_get_layout: * @theme: The PidginBlist theme. * Returns the layout to be used with the buddy list. * Returns: The buddy list layout. PidginBlistLayout *pidgin_blist_theme_get_layout(PidginBlistTheme *theme); * pidgin_blist_theme_get_expanded_background_color: * @theme: The PidginBlist theme. * Returns the background color to be used with expanded groups. GdkRGBA *pidgin_blist_theme_get_expanded_background_color(PidginBlistTheme *theme); * pidgin_blist_theme_get_expanded_text_info: * @theme: The PidginBlist theme. * Returns the text font and color to be used with expanded groups. * Returns: A font and color pair. PidginThemeFont *pidgin_blist_theme_get_expanded_text_info(PidginBlistTheme *theme); * pidgin_blist_theme_get_collapsed_background_color: * @theme: The PidginBlist theme. * Returns the background color to be used with collapsed groups. GdkRGBA *pidgin_blist_theme_get_collapsed_background_color(PidginBlistTheme *theme); * pidgin_blist_theme_get_collapsed_text_info: * @theme: The PidginBlist theme. * Returns the text font and color to be used with collapsed groups. * Returns: A font and color pair. PidginThemeFont *pidgin_blist_theme_get_collapsed_text_info(PidginBlistTheme *theme); * pidgin_blist_theme_get_contact_color: * @theme: The PidginBlist theme. * Returns the colors to be used for contacts and chats. * Returns: A gdkcolor for contacts and chats. GdkRGBA *pidgin_blist_theme_get_contact_color(PidginBlistTheme *theme); * pidgin_blist_theme_get_contact_text_info: * @theme: The PidginBlist theme. * Returns the text font and color to be used for expanded contacts. * Returns: A font and color pair. PidginThemeFont *pidgin_blist_theme_get_contact_text_info(PidginBlistTheme *theme); * pidgin_blist_theme_get_online_text_info: * @theme: The PidginBlist theme. * Returns the text font and color to be used for online buddies. * Returns: A font and color pair. PidginThemeFont *pidgin_blist_theme_get_online_text_info(PidginBlistTheme *theme); * pidgin_blist_theme_get_away_text_info: * @theme: The PidginBlist theme. * Returns the text font and color to be used for away and idle buddies. * Returns: A font and color pair. PidginThemeFont *pidgin_blist_theme_get_away_text_info(PidginBlistTheme *theme); * pidgin_blist_theme_get_offline_text_info: * @theme: The PidginBlist theme. * Returns the text font and color to be used for offline buddies. * Returns: A font and color pair. PidginThemeFont *pidgin_blist_theme_get_offline_text_info(PidginBlistTheme *theme); * pidgin_blist_theme_get_idle_text_info: * @theme: The PidginBlist theme. * Returns the text font and color to be used for idle buddies. * Returns: A font and color pair. PidginThemeFont *pidgin_blist_theme_get_idle_text_info(PidginBlistTheme *theme); * pidgin_blist_theme_get_unread_message_text_info: * @theme: The PidginBlist theme. * Returns the text font and color to be used for buddies with unread messages. * Returns: A font and color pair. PidginThemeFont *pidgin_blist_theme_get_unread_message_text_info(PidginBlistTheme *theme); * pidgin_blist_theme_get_unread_message_nick_said_text_info: * @theme: The PidginBlist theme. * Returns the text font and color to be used for chats with unread messages * that mention your nick. * Returns: A font and color pair. PidginThemeFont *pidgin_blist_theme_get_unread_message_nick_said_text_info(PidginBlistTheme *theme); * pidgin_blist_theme_get_status_text_info: * @theme: The PidginBlist theme. * Returns the text font and color to be used for a buddy's status message. * Returns: A font and color pair. PidginThemeFont *pidgin_blist_theme_get_status_text_info(PidginBlistTheme *theme); * pidgin_blist_theme_set_background_color: * @theme: The PidginBlist theme. * @color: The new background color. * Sets the background color to be used for this buddy list theme. void pidgin_blist_theme_set_background_color(PidginBlistTheme *theme, const GdkRGBA *color); * pidgin_blist_theme_set_opacity: * @theme: The PidginBlist theme. * @opacity: The new opacity setting. * Sets the opacity to be used for this buddy list theme. void pidgin_blist_theme_set_opacity(PidginBlistTheme *theme, gdouble opacity); * pidgin_blist_theme_set_layout: * @theme: The PidginBlist theme. * @layout: The new layout. * Sets the buddy list layout to be used for this buddy list theme. void pidgin_blist_theme_set_layout(PidginBlistTheme *theme, const PidginBlistLayout *layout); * pidgin_blist_theme_set_expanded_background_color: * @theme: The PidginBlist theme. * @color: The new background color. * Sets the background color to be used for expanded groups. void pidgin_blist_theme_set_expanded_background_color(PidginBlistTheme *theme, const GdkRGBA *color); * pidgin_blist_theme_set_expanded_text_info: * @theme: The PidginBlist theme. * @pair: The new text font and color pair. * Sets the text color and font to be used for expanded groups. void pidgin_blist_theme_set_expanded_text_info(PidginBlistTheme *theme, const PidginThemeFont *pair); * pidgin_blist_theme_set_collapsed_background_color: * @theme: The PidginBlist theme. * @color: The new background color. * Sets the background color to be used for collapsed groups. void pidgin_blist_theme_set_collapsed_background_color(PidginBlistTheme *theme, const GdkRGBA *color); * pidgin_blist_theme_set_collapsed_text_info: * @theme: The PidginBlist theme. * @pair: The new text font and color pair. * Sets the text color and font to be used for expanded groups. void pidgin_blist_theme_set_collapsed_text_info(PidginBlistTheme *theme, const PidginThemeFont *pair); * pidgin_blist_theme_set_contact_color: * @theme: The PidginBlist theme. * @color: The color to use for contacts and chats. * Sets the background color to be used for contacts and chats. void pidgin_blist_theme_set_contact_color(PidginBlistTheme *theme, const GdkRGBA *color); * pidgin_blist_theme_set_contact_text_info: * @theme: The PidginBlist theme. * @pair: The new text font and color pair. * Sets the text color and font to be used for expanded contacts. void pidgin_blist_theme_set_contact_text_info(PidginBlistTheme *theme, const PidginThemeFont *pair); * pidgin_blist_theme_set_online_text_info: * @theme: The PidginBlist theme. * @pair: The new text font and color pair. * Sets the text color and font to be used for online buddies. void pidgin_blist_theme_set_online_text_info(PidginBlistTheme *theme, const PidginThemeFont *pair); * pidgin_blist_theme_set_away_text_info: * @theme: The PidginBlist theme. * @pair: The new text font and color pair. * Sets the text color and font to be used for away and idle buddies. void pidgin_blist_theme_set_away_text_info(PidginBlistTheme *theme, const PidginThemeFont *pair); * pidgin_blist_theme_set_offline_text_info: * @theme: The PidginBlist theme. * @pair: The new text font and color pair. * Sets the text color and font to be used for offline buddies. void pidgin_blist_theme_set_offline_text_info(PidginBlistTheme *theme, const PidginThemeFont *pair); * pidgin_blist_theme_set_idle_text_info: * @theme: The PidginBlist theme. * @pair: The new text font and color pair. * Sets the text color and font to be used for idle buddies. void pidgin_blist_theme_set_idle_text_info(PidginBlistTheme *theme, const PidginThemeFont *pair); * pidgin_blist_theme_set_unread_message_text_info: * @theme: The PidginBlist theme. * @pair: The new text font and color pair. * Sets the text color and font to be used for buddies with unread messages. void pidgin_blist_theme_set_unread_message_text_info(PidginBlistTheme *theme, const PidginThemeFont *pair); * pidgin_blist_theme_set_unread_message_nick_said_text_info: * @theme: The PidginBlist theme. * @pair: The new text font and color pair. * Sets the text color and font to be used for a chat with unread messages * that mention your nick. void pidgin_blist_theme_set_unread_message_nick_said_text_info(PidginBlistTheme *theme, const PidginThemeFont *pair); * pidgin_blist_theme_set_status_text_info: * @theme: The PidginBlist theme. * @pair: The new text font and color pair. * Sets the text color and font to be used for buddy status messages. void pidgin_blist_theme_set_status_text_info(PidginBlistTheme *theme, const PidginThemeFont *pair); #endif /* PIDGIN_BLIST_THEME_H */