gtkutils.h

Go to the documentation of this file.

 
/* pidgin
 *
 * 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
 * source distribution.
 *
 * 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 _PIDGINUTILS_H_
#define _PIDGINUTILS_H_
 
#include "gtkconv.h"
#include "pidgin.h"
#include "prpl.h"
#include "util.h"
 
 
 
 
 
typedef enum
{
    PIDGIN_BUTTON_HORIZONTAL,
    PIDGIN_BUTTON_VERTICAL
 
} PidginButtonOrientation;
 
typedef enum
{
    PIDGIN_BUTTON_NONE = 0,
    PIDGIN_BUTTON_TEXT,
    PIDGIN_BUTTON_IMAGE,
    PIDGIN_BUTTON_TEXT_IMAGE
 
} PidginButtonStyle;
 
typedef enum
{
    PIDGIN_PRPL_ICON_SMALL,
    PIDGIN_PRPL_ICON_MEDIUM,
    PIDGIN_PRPL_ICON_LARGE
} PidginPrplIconSize;
 
#ifndef _WIN32
typedef enum
{
    PIDGIN_BROWSER_DEFAULT = 0,
    PIDGIN_BROWSER_CURRENT,
    PIDGIN_BROWSER_NEW_WINDOW,
    PIDGIN_BROWSER_NEW_TAB
 
} PidginBrowserPlace;
#endif /* _WIN32 */
 
typedef struct {
    gboolean is_buddy;
    union {
        PurpleBuddy *buddy;
        PurpleLogSet *logged_buddy;
    } entry;
} PidginBuddyCompletionEntry;
 
typedef gboolean (*PidginFilterBuddyCompletionEntryFunc) (const PidginBuddyCompletionEntry *completion_entry, gpointer user_data);
 
 
void pidgin_setup_imhtml(GtkWidget *imhtml);
 
GtkWidget *pidgin_create_imhtml(gboolean editable, GtkWidget **imhtml_ret, GtkWidget **toolbar_ret, GtkWidget **sw_ret);
 
GtkWidget *pidgin_create_small_button(GtkWidget *image);
 
GtkWidget *pidgin_create_window(const char *title, guint border_width, const char *role, gboolean resizable);
 
GtkWidget *pidgin_create_dialog(const char *title, guint border_width, const char *role, gboolean resizable);
 
GtkWidget *pidgin_dialog_get_vbox_with_properties(GtkDialog *dialog, gboolean homogeneous, gint spacing);
 
GtkWidget *pidgin_dialog_get_vbox(GtkDialog *dialog);
 
GtkWidget *pidgin_dialog_add_button(GtkDialog *dialog, const char *label,
        GCallback callback, gpointer callbackdata);
 
GtkWidget *pidgin_dialog_get_action_area(GtkDialog *dialog);
 
void pidgin_toggle_sensitive(GtkWidget *widget, GtkWidget *to_toggle);
 
void pidgin_set_sensitive_if_input(GtkWidget *entry, GtkWidget *dialog);
 
void pidgin_toggle_sensitive_array(GtkWidget *w, GPtrArray *data);
 
void pidgin_toggle_showhide(GtkWidget *widget, GtkWidget *to_toggle);
 
GtkWidget *pidgin_separator(GtkWidget *menu);
 
GtkWidget *pidgin_new_item(GtkWidget *menu, const char *str);
 
GtkWidget *pidgin_new_check_item(GtkWidget *menu, const char *str,
        GCallback cb, gpointer data, gboolean checked);
 
GtkWidget *pidgin_new_item_from_stock(GtkWidget *menu, const char *str,
                                    const char *icon, GCallback cb,
                                    gpointer data, guint accel_key,
                                    guint accel_mods, char *mod);
 
GtkWidget *pidgin_pixbuf_button_from_stock(const char *text, const char *icon,
                                         PidginButtonOrientation style);
 
GtkWidget *pidgin_pixbuf_toolbar_button_from_stock(const char *stock);
 
GtkWidget *pidgin_make_frame(GtkWidget *parent, const char *title);
 
GtkWidget *pidgin_protocol_option_menu_new(const char *id,
                                             GCallback cb,
                                             gpointer user_data);
 
const char *pidgin_protocol_option_menu_get_selected(GtkWidget *optmenu);
 
GtkWidget *pidgin_account_option_menu_new(PurpleAccount *default_account,
        gboolean show_all, GCallback cb,
        PurpleFilterAccountFunc filter_func, gpointer user_data);
 
PurpleAccount *pidgin_account_option_menu_get_selected(GtkWidget *optmenu);
 
void pidgin_account_option_menu_set_selected(GtkWidget *optmenu, PurpleAccount *account);
 
void pidgin_setup_screenname_autocomplete_with_filter(GtkWidget *entry, GtkWidget *optmenu, PidginFilterBuddyCompletionEntryFunc filter_func, gpointer user_data);
 
gboolean pidgin_screenname_autocomplete_default_filter(const PidginBuddyCompletionEntry *completion_entry, gpointer all_accounts);
 
void pidgin_setup_screenname_autocomplete(GtkWidget *entry, GtkWidget *optmenu, gboolean all);
 
gboolean pidgin_check_if_dir(const char *path, GtkFileSelection *filesel);
 
void pidgin_setup_gtkspell(GtkTextView *textview);
 
void pidgin_save_accels_cb(GtkAccelGroup *accel_group, guint arg1,
                             GdkModifierType arg2, GClosure *arg3,
                             gpointer data);
 
gboolean pidgin_save_accels(gpointer data);
 
void pidgin_load_accels(void);
 
void pidgin_retrieve_user_info(PurpleConnection *conn, const char *name);
 
void pidgin_retrieve_user_info_in_chat(PurpleConnection *conn, const char *name, int chatid);
 
gboolean pidgin_parse_x_im_contact(const char *msg, gboolean all_accounts,
                                     PurpleAccount **ret_account,
                                     char **ret_protocol, char **ret_username,
                                     char **ret_alias);
 
void pidgin_set_accessible_label(GtkWidget *w, GtkWidget *l);
 
void pidgin_set_accessible_relations(GtkWidget *w, GtkWidget *l);
 
void pidgin_menu_position_func_helper(GtkMenu *menu, gint *x, gint *y,
                                        gboolean *push_in, gpointer data);
 
void pidgin_treeview_popup_menu_position_func(GtkMenu *menu,
                                                gint *x,
                                                gint *y,
                                                gboolean *push_in,
                                                gpointer user_data);
 
void pidgin_dnd_file_manage(GtkSelectionData *sd, PurpleAccount *account, const char *who);
 
void pidgin_buddy_icon_get_scale_size(GdkPixbuf *buf, PurpleBuddyIconSpec *spec, PurpleIconScaleRules rules, int *width, int *height);
 
GdkPixbuf *pidgin_create_prpl_icon(PurpleAccount *account, PidginPrplIconSize size);
 
GdkPixbuf * pidgin_create_status_icon(PurpleStatusPrimitive primitive, GtkWidget *w, const char *size);
 
const char *pidgin_stock_id_from_status_primitive(PurpleStatusPrimitive prim);
 
const char *pidgin_stock_id_from_presence(PurplePresence *presence);
 
GtkWidget *pidgin_append_menu_action(GtkWidget *menu, PurpleMenuAction *act,
                                 gpointer gobject);
 
void pidgin_set_cursor(GtkWidget *widget, GdkCursorType cursor_type);
 
void pidgin_clear_cursor(GtkWidget *widget);
 
GtkWidget *pidgin_buddy_icon_chooser_new(GtkWindow *parent, void(*callback)(const char*,gpointer), gpointer data);
 
gpointer pidgin_convert_buddy_icon(PurplePlugin *plugin, const char *path, size_t *len);
 
#if !(defined PIDGIN_DISABLE_DEPRECATED) || (defined _PIDGIN_GTKUTILS_C_)
void pidgin_set_custom_buddy_icon(PurpleAccount *account, const char *who, const char *filename);
#endif
 
char *pidgin_make_pretty_arrows(const char *str);
 
typedef void (*PidginUtilMiniDialogCallback)(gpointer user_data, GtkButton *);
 
GtkWidget *pidgin_make_mini_dialog(PurpleConnection *handle,
    const char* stock_id, const char *primary, const char *secondary,
    void *user_data, ...) G_GNUC_NULL_TERMINATED;
 
GtkWidget *pidgin_make_mini_dialog_with_custom_icon(PurpleConnection *gc,
    GdkPixbuf *custom_icon,
    const char *primary,
    const char *secondary,
    void *user_data,
    ...) G_GNUC_NULL_TERMINATED;
 
gboolean pidgin_tree_view_search_equal_func(GtkTreeModel *model, gint column,
            const gchar *key, GtkTreeIter *iter, gpointer data);
 
void pidgin_set_urgent(GtkWindow *window, gboolean urgent);
 
gboolean pidgin_gdk_pixbuf_is_opaque(GdkPixbuf *pixbuf);
 
void pidgin_gdk_pixbuf_make_round(GdkPixbuf *pixbuf);
 
const char *pidgin_get_dim_grey_string(GtkWidget *widget);
 
GtkWidget *pidgin_text_combo_box_entry_new(const char *default_item, GList *items);
 
const char *pidgin_text_combo_box_entry_get_text(GtkWidget *widget);
 
void pidgin_text_combo_box_entry_set_text(GtkWidget *widget, const char *text);
 
gboolean pidgin_auto_parent_window(GtkWidget *window);
 
GtkWidget *pidgin_add_widget_to_vbox(GtkBox *vbox, const char *widget_label, GtkSizeGroup *sg, GtkWidget *widget, gboolean expand, GtkWidget **p_label);
 
GdkPixbuf *pidgin_pixbuf_from_data(const guchar *buf, gsize count);
 
GdkPixbufAnimation *pidgin_pixbuf_anim_from_data(const guchar *buf, gsize count);
 
GdkPixbuf *pidgin_pixbuf_from_imgstore(PurpleStoredImage *image);
 
GdkPixbuf *pidgin_pixbuf_new_from_file(const char *filename);
 
GdkPixbuf *pidgin_pixbuf_new_from_file_at_size(const char *filename, int width, int height);
 
GdkPixbuf *pidgin_pixbuf_new_from_file_at_scale(const char *filename, int width, int height, gboolean preserve_aspect_ratio);
 
GtkWidget *pidgin_make_scrollable(GtkWidget *child, GtkPolicyType hscrollbar_policy, GtkPolicyType vscrollbar_policy, GtkShadowType shadow_type, int width, int height);
 
void pidgin_utils_init(void);
 
void pidgin_utils_uninit(void);
 
#endif /* _PIDGINUTILS_H_ */