libempathy-gtk/empathy-ui-utils.h

   1 /*
   2  * Copyright (C) 2002-2007 Imendio AB
   3  * Copyright (C) 2007-2010 Collabora Ltd.
   4  *
   5  * This program is free software; you can redistribute it and/or
   6  * modify it under the terms of the GNU General Public License as
   7  * published by the Free Software Foundation; either version 2 of the
   8  * License, or (at your option) any later version.
   9  *
  10  * This program 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  * General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public
  16  * License along with this program; if not, write to the
  17  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
  18  * Boston, MA  02110-1301  USA
  19  *
  20  * Authors: Mikael Hallendal <micke@imendio.com>
  21  *          Richard Hult <richard@imendio.com>
  22  *          Martyn Russell <martyn@imendio.com>
  23  *          Xavier Claessens <xclaesse@gmail.com>
  24  *          Jonny Lamb <jonny.lamb@collabora.co.uk>
  25  *          Travis Reitter <travis.reitter@collabora.co.uk>
  26  *
  27  *          Part of this file is copied from GtkSourceView (gtksourceiter.c):
  28  *          Paolo Maggi
  29  *          Jeroen Zwartepoorte
  30  */
  31
  32 #ifndef __EMPATHY_UI_UTILS_H__
  33 #define __EMPATHY_UI_UTILS_H__
  34
  35 #include <gtk/gtk.h>
  36
  37 #include <folks/folks.h>
  38
  39 #include <libempathy/empathy-contact.h>
  40 #include <libempathy/empathy-ft-handler.h>
  41
  42 G_BEGIN_DECLS
  43
  44 #define EMPATHY_RECT_IS_ON_SCREEN(x,y,w,h) ((x) + (w) > 0 && \
  45               (y) + (h) > 0 && \
  46               (x) < gdk_screen_width () && \
  47               (y) < gdk_screen_height ())
  48
  49 typedef void (*EmpathyPixbufAvatarFromIndividualCb) (
  50     FolksIndividual *individual,
  51     GdkPixbuf *pixbuf,
  52     gpointer user_data);
  53
  54 void empathy_gtk_init (void);
  55
  56 /* Glade */
  57 GtkBuilder * empathy_builder_get_file (const gchar *filename,
  58     const gchar *first_object,
  59     ...);
  60 void empathy_builder_connect (GtkBuilder *gui,
  61     gpointer user_data,
  62     const gchar *first_object,
  63     ...);
  64 GtkWidget * empathy_builder_unref_and_keep_widget (GtkBuilder *gui,
  65     GtkWidget *root);
  66
  67 /* Pixbufs */
  68 const gchar * empathy_icon_name_for_presence (
  69     TpConnectionPresenceType presence);
  70 const gchar * empathy_icon_name_for_contact (EmpathyContact *contact);
  71 const gchar * empathy_icon_name_for_individual (FolksIndividual *individual);
  72 const gchar * empathy_protocol_name_for_contact (EmpathyContact *contact);
  73 GdkPixbuf * empathy_pixbuf_from_data (gchar *data,
  74     gsize data_size);
  75 GdkPixbuf * empathy_pixbuf_from_data_and_mime (gchar *data,
  76     gsize data_size,
  77     gchar **mime_type);
  78 void empathy_pixbuf_avatar_from_individual_scaled_async (
  79     FolksIndividual *individual,
  80     gint width,
  81     gint height,
  82     GCancellable *cancellable,
  83     GAsyncReadyCallback callback,
  84     gpointer user_data);
  85 GdkPixbuf * empathy_pixbuf_avatar_from_individual_scaled_finish (
  86     FolksIndividual *individual,
  87     GAsyncResult *result,
  88     GError **error);
  89 GdkPixbuf * empathy_pixbuf_from_avatar_scaled (EmpathyAvatar *avatar,
  90     gint width,
  91     gint height);
  92 GdkPixbuf * empathy_pixbuf_avatar_from_contact_scaled (EmpathyContact *contact,
  93     gint width,
  94     gint height);
  95 GdkPixbuf * empathy_pixbuf_protocol_from_contact_scaled (
  96     EmpathyContact *contact,
  97     gint width,
  98     gint height);
  99 GdkPixbuf * empathy_pixbuf_contact_status_icon (EmpathyContact *contact,
 100     gboolean show_protocol);
 101 GdkPixbuf * empathy_pixbuf_contact_status_icon_with_icon_name (
 102     EmpathyContact *contact,
 103     const gchar *icon_name,
 104     gboolean show_protocol);
 105 GdkPixbuf * empathy_pixbuf_scale_down_if_necessary (GdkPixbuf *pixbuf,
 106     gint max_size);
 107 GdkPixbuf * empathy_pixbuf_from_icon_name (const gchar *icon_name,
 108     GtkIconSize icon_size);
 109 GdkPixbuf * empathy_pixbuf_from_icon_name_sized (const gchar *icon_name,
 110     gint size);
 111 gchar * empathy_filename_from_icon_name (const gchar *icon_name,
 112     GtkIconSize icon_size);
 113
 114 /* Text view */
 115 gboolean empathy_text_iter_forward_search (const GtkTextIter*iter,
 116     const gchar *str,
 117     GtkTextIter *match_start,
 118     GtkTextIter *match_end,
 119     const GtkTextIter*limit);
 120 gboolean empathy_text_iter_backward_search (const GtkTextIter*iter,
 121     const gchar *str,
 122     GtkTextIter *match_start,
 123     GtkTextIter *match_end,
 124     const GtkTextIter *limit);
 125
 126 /* Windows */
 127 void empathy_window_present (GtkWindow *window);
 128 void empathy_window_present_with_time (GtkWindow *window,
 129     guint32 timestamp);
 130 GtkWindow * empathy_get_toplevel_window (GtkWidget *widget);
 131
 132 void empathy_move_to_window_desktop (GtkWindow *window,
 133     guint32 timestamp);
 134
 135 /* URL */
 136 gchar * empathy_make_absolute_url (const gchar *url);
 137
 138 gchar * empathy_make_absolute_url_len (const gchar *url,
 139     guint len);
 140 void empathy_url_show (GtkWidget *parent,
 141     const char *url);
 142
 143 /* File transfer */
 144 void empathy_send_file (EmpathyContact *contact,
 145     GFile *file);
 146 void empathy_send_file_from_uri_list (EmpathyContact *contact,
 147     const gchar *uri_list);
 148 void empathy_send_file_with_file_chooser (EmpathyContact *contact);
 149 void empathy_receive_file_with_file_chooser (EmpathyFTHandler *handler);
 150
 151 /* Misc */
 152 void  empathy_make_color_whiter (GdkRGBA *color);
 153
 154 GtkWidget * empathy_context_menu_new (GtkWidget *attach_to);
 155
 156 gint64 empathy_get_current_action_time (void);
 157
 158 gboolean empathy_individual_match_string (
 159     FolksIndividual *individual,
 160     const gchar *text,
 161     GPtrArray *words);
 162
 163 void empathy_launch_program (const gchar *dir,
 164     const gchar *name,
 165     const gchar *args);
 166
 167 void empathy_set_css_provider (GtkWidget *widget);
 168
 169 G_END_DECLS
 170
 171 #endif /*  __EMPATHY_UI_UTILS_H__ */