aboutsummaryrefslogtreecommitdiffstats
path: root/libempathy-gtk/empathy-ui-utils.h
blob: 925ecc5cb00c5db4fca2887a751bf1a56b6afe3b (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
/*
 * Copyright (C) 2002-2007 Imendio AB
 * Copyright (C) 2007-2008 Collabora Ltd.
 *
 * 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 St, Fifth Floor,
 * Boston, MA  02110-1301  USA
 *
 * Authors: Mikael Hallendal <micke@imendio.com>
 *          Richard Hult <richard@imendio.com>
 *          Martyn Russell <martyn@imendio.com>
 *          Xavier Claessens <xclaesse@gmail.com>
 *          Jonny Lamb <jonny.lamb@collabora.co.uk>
 *
 *          Part of this file is copied from GtkSourceView (gtksourceiter.c):
 *          Paolo Maggi
 *          Jeroen Zwartepoorte
 */

#ifndef __EMPATHY_UI_UTILS_H__
#define __EMPATHY_UI_UTILS_H__

#include <gtk/gtk.h>

#include <libempathy/empathy-contact.h>
#include <libempathy/empathy-ft-handler.h>

#include "empathy-chat-view.h"

G_BEGIN_DECLS

#define EMPATHY_RECT_IS_ON_SCREEN(x,y,w,h) ((x) + (w) > 0 && \
                        (y) + (h) > 0 && \
                        (x) < gdk_screen_width () && \
                        (y) < gdk_screen_height ())

void            empathy_gtk_init                        (void);
GRegex *        empathy_uri_regex_dup_singleton         (void);

/* Glade */
GtkBuilder *    empathy_builder_get_file                (const gchar      *filename,
                             const gchar      *first_object,
                             ...);
void            empathy_builder_connect                 (GtkBuilder       *gui,
                             gpointer          user_data,
                             gchar            *first_object,
                             ...);
GtkWidget     *empathy_builder_unref_and_keep_widget    (GtkBuilder       *gui,
                             GtkWidget        *root);

/* Pixbufs */
const gchar * empathy_icon_name_for_presence            (TpConnectionPresenceType  presence);
const gchar * empathy_icon_name_for_contact             (EmpathyContact   *contact);
const gchar * empathy_protocol_name_for_contact         (EmpathyContact   *contact);
GdkPixbuf *   empathy_pixbuf_from_data                  (gchar            *data,
                             gsize             data_size);
GdkPixbuf *   empathy_pixbuf_from_data_and_mime         (gchar            *data,
                             gsize             data_size,
                             gchar           **mime_type);
GdkPixbuf *   empathy_pixbuf_from_avatar_scaled         (EmpathyAvatar    *avatar,
                             gint              width,
                             gint              height);
GdkPixbuf *   empathy_pixbuf_avatar_from_contact_scaled (EmpathyContact   *contact,
                             gint              width,
                             gint              height);
GdkPixbuf *   empathy_pixbuf_protocol_from_contact_scaled (EmpathyContact   *contact,
                             gint              width,
                             gint              height);
GdkPixbuf *   empathy_pixbuf_contact_status_icon (EmpathyContact   *contact,
                             gboolean          show_protocol);
GdkPixbuf *   empathy_pixbuf_contact_status_icon_with_icon_name (EmpathyContact   *contact,
                             const gchar       *icon_name,
                             gboolean          show_protocol);
GdkPixbuf *   empathy_pixbuf_scale_down_if_necessary    (GdkPixbuf        *pixbuf,
                             gint              max_size);
GdkPixbuf *   empathy_pixbuf_from_icon_name             (const gchar      *icon_name,
                             GtkIconSize       icon_size);
GdkPixbuf *   empathy_pixbuf_from_icon_name_sized       (const gchar      *icon_name,
                             gint              size);
gchar *       empathy_filename_from_icon_name           (const gchar      *icon_name,
                             GtkIconSize       icon_size);

/* Text view */
gboolean    empathy_text_iter_forward_search            (const GtkTextIter*iter,
                             const gchar      *str,
                             GtkTextIter      *match_start,
                             GtkTextIter      *match_end,
                             const GtkTextIter*limit);
gboolean    empathy_text_iter_backward_search           (const GtkTextIter*iter,
                             const gchar      *str,
                             GtkTextIter      *match_start,
                             GtkTextIter      *match_end,
                             const GtkTextIter*limit);
/* Windows */
gboolean    empathy_window_get_is_visible               (GtkWindow        *window);
void        empathy_window_present                      (GtkWindow        *window,
                             gboolean          steal_focus);
void        empathy_window_iconify                      (GtkWindow        *window,
                             GtkStatusIcon    *status_icon);
GtkWindow * empathy_get_toplevel_window                 (GtkWidget        *widget);
void        empathy_url_show                            (GtkWidget        *parent,
                             const char       *url);
void        empathy_toggle_button_set_state_quietly     (GtkWidget        *widget,
                             GCallback         callback,
                             gpointer          user_data,
                             gboolean          active);
GtkWidget * empathy_link_button_new                     (const gchar      *url,
                             const gchar      *title);

void        empathy_send_file                           (EmpathyContact   *contact,
                             GFile            *file);
void        empathy_send_file_from_uri_list             (EmpathyContact   *contact,
                             const gchar      *uri_list);
void        empathy_send_file_with_file_chooser         (EmpathyContact   *contact);
void        empathy_receive_file_with_file_chooser      (EmpathyFTHandler *handler);

gchar *     empathy_make_absolute_url                   (const gchar *url);
gchar *     empathy_make_absolute_url_len               (const gchar *url,
                             guint len);

/* String parser */
typedef struct _EmpathyStringParser EmpathyStringParser;

typedef void (*EmpathyStringReplace) (const gchar *text,
                      gssize len,
                      gpointer match_data,
                      gpointer user_data);
typedef void (*EmpathyStringMatch) (const gchar *text,
                    gssize len,
                    EmpathyStringReplace replace_func,
                    EmpathyStringParser *sub_parsers,
                    gpointer user_data);

struct _EmpathyStringParser {
    EmpathyStringMatch match_func;
    EmpathyStringReplace replace_func;
};

void
empathy_string_parser_substr (const gchar *text,
                  gssize len,
                  EmpathyStringParser *parsers,
                  gpointer user_data);

void
empathy_string_match_link (const gchar *text,
               gssize len,
               EmpathyStringReplace replace_func,
               EmpathyStringParser *sub_parsers,
               gpointer user_data);

void
empathy_string_match_smiley (const gchar *text,
                 gssize len,
                 EmpathyStringReplace replace_func,
                 EmpathyStringParser *sub_parsers,
                 gpointer user_data);

void
empathy_string_match_all (const gchar *text,
              gssize len,
              EmpathyStringReplace replace_func,
              EmpathyStringParser *sub_parsers,
              gpointer user_data);

G_END_DECLS

#endif /*  __EMPATHY_UI_UTILS_H__ */