Mercurial > pidgin
annotate src/gtkutils.h @ 9478:0efa260e384f
[gaim-migrate @ 10303]
" This patch adds the following features for zephyr, in order
of usefulness :-)
Protocol action (Retrieve subscriptions from server) to
list user's subscriptions (chats) in a popup window.
Typing notification - (both sending and receiving --
using zephyrs with opcode ping).
Correct interpretation of %host% and %canon% entries in
.zephyr.subs . These are often used to subscribe to
system messages concerning a specific machine (by
hostname and canonical hostname, respectively).
An updated .todo list." --Arun A Tharuvai
committer: Tailor Script <tailor@pidgin.im>
author | Luke Schierer <lschiere@pidgin.im> |
---|---|
date | Wed, 07 Jul 2004 21:56:57 +0000 |
parents | 4ff4c34b7500 |
children | 44a5bfa4730b |
rev | line source |
---|---|
4359 | 1 /** |
2 * @file gtkutils.h GTK+ utility functions | |
5034
4691c5936c01
[gaim-migrate @ 5377]
Christian Hammond <chipx86@chipx86.com>
parents:
4687
diff
changeset
|
3 * @ingroup gtkui |
4359 | 4 * |
5 * gaim | |
6 * | |
8046 | 7 * Gaim is the legal property of its developers, whose names are too numerous |
8 * to list here. Please refer to the COPYRIGHT file distributed with this | |
9 * source distribution. | |
6646
b89d98f0bf79
[gaim-migrate @ 7171]
Christian Hammond <chipx86@chipx86.com>
parents:
6372
diff
changeset
|
10 * |
4359 | 11 * This program is free software; you can redistribute it and/or modify |
12 * it under the terms of the GNU General Public License as published by | |
13 * the Free Software Foundation; either version 2 of the License, or | |
14 * (at your option) any later version. | |
15 * | |
16 * This program is distributed in the hope that it will be useful, | |
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
19 * GNU General Public License for more details. | |
20 * | |
21 * You should have received a copy of the GNU General Public License | |
22 * along with this program; if not, write to the Free Software | |
23 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA | |
24 */ | |
25 #ifndef _GAIM_GTK_UTILS_H_ | |
26 #define _GAIM_GTK_UTILS_H_ | |
27 | |
5872
059d95c67cda
[gaim-migrate @ 6304]
Christian Hammond <chipx86@chipx86.com>
parents:
5676
diff
changeset
|
28 #include <gtk/gtk.h> |
059d95c67cda
[gaim-migrate @ 6304]
Christian Hammond <chipx86@chipx86.com>
parents:
5676
diff
changeset
|
29 #include "gtkconv.h" |
5644
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
30 #include "prpl.h" |
4359 | 31 |
6372
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
32 typedef enum |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
33 { |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
34 GAIM_BUTTON_HORIZONTAL, |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
35 GAIM_BUTTON_VERTICAL |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
36 |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
37 } GaimButtonOrientation; |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
38 |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
39 typedef enum |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
40 { |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
41 GAIM_BUTTON_NONE = 0, |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
42 GAIM_BUTTON_TEXT, |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
43 GAIM_BUTTON_IMAGE, |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
44 GAIM_BUTTON_TEXT_IMAGE |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
45 |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
46 } GaimButtonStyle; |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
47 |
8272 | 48 #ifndef _WIN32 |
49 typedef enum | |
50 { | |
51 GAIM_BROWSER_DEFAULT = 0, | |
52 GAIM_BROWSER_CURRENT, | |
53 GAIM_BROWSER_NEW_WINDOW, | |
54 GAIM_BROWSER_NEW_TAB | |
8741
b994b0223335
[gaim-migrate @ 9496]
Christian Hammond <chipx86@chipx86.com>
parents:
8735
diff
changeset
|
55 |
8272 | 56 } GaimBrowserPlace; |
57 #endif /* _WIN32 */ | |
58 | |
7420 | 59 extern guint accels_save_timer; |
60 | |
4359 | 61 /** |
62 * Sets up a gtkimhtml widget, loads it with smileys, and sets the | |
63 * default signal handlers. | |
64 * | |
65 * @param imhtml The gtkimhtml widget to setup. | |
66 */ | |
67 void gaim_setup_imhtml(GtkWidget *imhtml); | |
68 | |
69 /** | |
70 * Displays a dialog for saving the buddy icon in a conversation. | |
71 * | |
72 * @param obj @c NULL | |
73 * @param conv The conversation. | |
74 */ | |
5676
dae79aefac8d
[gaim-migrate @ 6094]
Christian Hammond <chipx86@chipx86.com>
parents:
5644
diff
changeset
|
75 void gaim_gtk_save_icon_dialog(GtkObject *obj, GaimConversation *conv); |
4359 | 76 |
77 /** | |
78 * Returns the display style for buttons for the specified conversation | |
79 * type. | |
80 * | |
81 * @param type The conversation type. | |
82 * | |
83 * @return The display style. | |
84 */ | |
85 int gaim_gtk_get_dispstyle(GaimConversationType type); | |
86 | |
87 /** | |
88 * Changes a button to be either text or image, depending on | |
89 * preferences. | |
90 * | |
91 * This function destroys the old button pointed to by @a button and | |
92 * returns the new replacement button. | |
93 * | |
94 * @param text The text for the button. | |
95 * @param button The button widget. | |
96 * @param stock The stock image. | |
97 * @param type The conversation type the button belongs to. | |
98 * | |
99 * @return The new button widget to replace the old one. | |
100 */ | |
101 GtkWidget *gaim_gtk_change_text(const char *text, GtkWidget *button, | |
102 const char *stock, GaimConversationType type); | |
103 | |
104 /** | |
105 * Toggles the sensitivity of a widget. | |
106 * | |
107 * @param widget @c NULL. Used for signal handlers. | |
108 * @param to_toggle The widget to toggle. | |
109 */ | |
110 void gaim_gtk_toggle_sensitive(GtkWidget *widget, GtkWidget *to_toggle); | |
111 | |
4687 | 112 /** |
7751 | 113 * Checks if text has been entered into a GtkTextEntry widget. If |
114 * so, the GTK_RESPONSE_OK on the given dialog is set to TRUE. | |
115 * Otherwise GTK_RESPONSE_OK is set to FALSE. | |
116 * | |
117 * @param entry The text entry widget. | |
118 * @param dialog The dialog containing the text entry widget. | |
119 */ | |
120 void gaim_gtk_set_sensitive_if_input(GtkWidget *entry, GtkWidget *dialog); | |
121 | |
122 /** | |
5319
3adb20b869b4
[gaim-migrate @ 5691]
Christian Hammond <chipx86@chipx86.com>
parents:
5162
diff
changeset
|
123 * Toggles the sensitivity of all widgets in a pointer array. |
3adb20b869b4
[gaim-migrate @ 5691]
Christian Hammond <chipx86@chipx86.com>
parents:
5162
diff
changeset
|
124 * |
6720
41120df7ed94
[gaim-migrate @ 7247]
Christian Hammond <chipx86@chipx86.com>
parents:
6646
diff
changeset
|
125 * @param w @c NULL. Used for signal handlers. |
41120df7ed94
[gaim-migrate @ 7247]
Christian Hammond <chipx86@chipx86.com>
parents:
6646
diff
changeset
|
126 * @param data The array containing the widgets to toggle. |
5319
3adb20b869b4
[gaim-migrate @ 5691]
Christian Hammond <chipx86@chipx86.com>
parents:
5162
diff
changeset
|
127 */ |
3adb20b869b4
[gaim-migrate @ 5691]
Christian Hammond <chipx86@chipx86.com>
parents:
5162
diff
changeset
|
128 void gtk_toggle_sensitive_array(GtkWidget *w, GPtrArray *data); |
3adb20b869b4
[gaim-migrate @ 5691]
Christian Hammond <chipx86@chipx86.com>
parents:
5162
diff
changeset
|
129 |
3adb20b869b4
[gaim-migrate @ 5691]
Christian Hammond <chipx86@chipx86.com>
parents:
5162
diff
changeset
|
130 /** |
8901 | 131 * Toggles the visibility of a widget. |
132 * | |
133 * @param widget @c NULL. Used for signal handlers. | |
134 * @param to_toggle The widget to toggle. | |
135 */ | |
136 void gaim_gtk_toggle_showhide(GtkWidget *widget, GtkWidget *to_toggle); | |
137 | |
138 /** | |
8735
92cbf9713795
[gaim-migrate @ 9490]
Christian Hammond <chipx86@chipx86.com>
parents:
8289
diff
changeset
|
139 * Adds a separator to a menu. |
4687 | 140 * |
8735
92cbf9713795
[gaim-migrate @ 9490]
Christian Hammond <chipx86@chipx86.com>
parents:
8289
diff
changeset
|
141 * @param menu The menu to add a separator to. |
4687 | 142 */ |
143 void gaim_separator(GtkWidget *menu); | |
144 | |
5162 | 145 /** |
146 * Creates a menu item. | |
147 * | |
148 * @param menu The menu to which to append the menu item. | |
149 * @param str The title to use for the newly created menu item. | |
150 * | |
151 * @return The newly created menu item. | |
152 */ | |
5906 | 153 GtkWidget *gaim_new_item(GtkWidget *menu, const char *str); |
154 | |
155 /** | |
156 * Creates a check menu item. | |
157 * | |
158 * @param menu The menu to which to append the check menu item. | |
159 * @param str The title to use for the newly created menu item. | |
160 * @param sf A function to call when the menu item is activated. | |
161 * @param data Data to pass to the signal function. | |
162 * @param checked The initial state of the check item | |
163 * | |
164 * @return The newly created menu item. | |
165 */ | |
166 GtkWidget *gaim_new_check_item(GtkWidget *menu, const char *str, | |
167 GtkSignalFunc sf, gpointer data, gboolean checked); | |
5162 | 168 |
169 /** | |
170 * Creates a menu item. | |
171 * | |
172 * @param menu The menu to which to append the menu item. | |
173 * @param str The title for the menu item. | |
5530
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
174 * @param icon An icon to place to the left of the menu item, |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
175 * or @c NULL for no icon. |
5162 | 176 * @param sf A function to call when the menu item is activated. |
177 * @param data Data to pass to the signal function. | |
178 * @param accel_key Something. | |
179 * @param accel_mods Something. | |
180 * @param mod Something. | |
181 * | |
182 * @return The newly created menu item. | |
183 */ | |
5530
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
184 GtkWidget *gaim_new_item_from_stock(GtkWidget *menu, const char *str, |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
185 const char *icon, GtkSignalFunc sf, |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
186 gpointer data, guint accel_key, |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
187 guint accel_mods, char *mod); |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
188 |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
189 /** |
6372
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
190 * Creates a button with the specified text and stock icon. |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
191 * |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
192 * @param text The text for the button. |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
193 * @param icon The stock icon name. |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
194 * @param style The orientation of the button. |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
195 * |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
196 * @return The button. |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
197 */ |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
198 GtkWidget *gaim_pixbuf_button_from_stock(const char *text, const char *icon, |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
199 GaimButtonOrientation style); |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
200 |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
201 /** |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
202 * Creates a toolbar button with the stock icon. |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
203 * |
6720
41120df7ed94
[gaim-migrate @ 7247]
Christian Hammond <chipx86@chipx86.com>
parents:
6646
diff
changeset
|
204 * @param stock The stock icon name. |
6372
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
205 * |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
206 * @return The button. |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
207 */ |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
208 GtkWidget *gaim_pixbuf_toolbar_button_from_stock(const char *stock); |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
209 |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
210 /** |
5530
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
211 * Creates a HIG preferences frame. |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
212 * |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
213 * @param parent The widget to put the frame into. |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
214 * @param title The title for the frame. |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
215 * |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
216 * @return The vbox to put things into. |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
217 */ |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
218 GtkWidget *gaim_gtk_make_frame(GtkWidget *parent, const char *title); |
5162 | 219 |
5644
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
220 /** |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
221 * Creates a drop-down option menu filled with protocols. |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
222 * |
7956 | 223 * @param id The protocol to select by default. |
5644
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
224 * @param cb The callback to call when a protocol is selected. |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
225 * @param user_data Data to pass to the callback function. |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
226 * |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
227 * @return The drop-down option menu. |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
228 */ |
7956 | 229 GtkWidget *gaim_gtk_protocol_option_menu_new(const char *id, |
5644
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
230 GCallback cb, |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
231 gpointer user_data); |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
232 |
5877
f336fc0a7b8b
[gaim-migrate @ 6309]
Christian Hammond <chipx86@chipx86.com>
parents:
5872
diff
changeset
|
233 /** |
f336fc0a7b8b
[gaim-migrate @ 6309]
Christian Hammond <chipx86@chipx86.com>
parents:
5872
diff
changeset
|
234 * Creates a drop-down option menu filled with accounts. |
f336fc0a7b8b
[gaim-migrate @ 6309]
Christian Hammond <chipx86@chipx86.com>
parents:
5872
diff
changeset
|
235 * |
8289
e39ea2b4f6cd
[gaim-migrate @ 9013]
Christian Hammond <chipx86@chipx86.com>
parents:
8272
diff
changeset
|
236 * @param default_account The account to select by default. |
e39ea2b4f6cd
[gaim-migrate @ 9013]
Christian Hammond <chipx86@chipx86.com>
parents:
8272
diff
changeset
|
237 * @param show_all Whether or not to show all accounts, or just |
e39ea2b4f6cd
[gaim-migrate @ 9013]
Christian Hammond <chipx86@chipx86.com>
parents:
8272
diff
changeset
|
238 * active accounts. |
e39ea2b4f6cd
[gaim-migrate @ 9013]
Christian Hammond <chipx86@chipx86.com>
parents:
8272
diff
changeset
|
239 * @param cb The callback to call when an account is selected. |
e39ea2b4f6cd
[gaim-migrate @ 9013]
Christian Hammond <chipx86@chipx86.com>
parents:
8272
diff
changeset
|
240 * @param filter_func A function for checking if an account should |
e39ea2b4f6cd
[gaim-migrate @ 9013]
Christian Hammond <chipx86@chipx86.com>
parents:
8272
diff
changeset
|
241 * be shown. This can be NULL. |
e39ea2b4f6cd
[gaim-migrate @ 9013]
Christian Hammond <chipx86@chipx86.com>
parents:
8272
diff
changeset
|
242 * @param user_data Data to pass to the callback function. |
5877
f336fc0a7b8b
[gaim-migrate @ 6309]
Christian Hammond <chipx86@chipx86.com>
parents:
5872
diff
changeset
|
243 * |
f336fc0a7b8b
[gaim-migrate @ 6309]
Christian Hammond <chipx86@chipx86.com>
parents:
5872
diff
changeset
|
244 * @return The drop-down option menu. |
f336fc0a7b8b
[gaim-migrate @ 6309]
Christian Hammond <chipx86@chipx86.com>
parents:
5872
diff
changeset
|
245 */ |
f336fc0a7b8b
[gaim-migrate @ 6309]
Christian Hammond <chipx86@chipx86.com>
parents:
5872
diff
changeset
|
246 GtkWidget *gaim_gtk_account_option_menu_new(GaimAccount *default_account, |
6646
b89d98f0bf79
[gaim-migrate @ 7171]
Christian Hammond <chipx86@chipx86.com>
parents:
6372
diff
changeset
|
247 gboolean show_all, GCallback cb, |
8289
e39ea2b4f6cd
[gaim-migrate @ 9013]
Christian Hammond <chipx86@chipx86.com>
parents:
8272
diff
changeset
|
248 GaimFilterAccountFunc filter_func, gpointer user_data); |
5877
f336fc0a7b8b
[gaim-migrate @ 6309]
Christian Hammond <chipx86@chipx86.com>
parents:
5872
diff
changeset
|
249 |
5943
a4f2aba0848d
[gaim-migrate @ 6384]
Christian Hammond <chipx86@chipx86.com>
parents:
5906
diff
changeset
|
250 /** |
8940 | 251 * Gets the currently selected account from an account drop down box. |
252 * | |
253 * @param optmenu The GtkOptionMenu created by | |
254 * gaim_gtk_account_option_menu_new. | |
255 * @return Returns the GaimAccount that is currently selected. | |
256 */ | |
257 GaimAccount *gaim_gtk_account_option_menu_get_selected(GtkWidget *optmenu); | |
258 | |
259 /** | |
6646
b89d98f0bf79
[gaim-migrate @ 7171]
Christian Hammond <chipx86@chipx86.com>
parents:
6372
diff
changeset
|
260 * Check if the given path is a directory or not. If it is, then modify |
5966 | 261 * the given GtkFileSelection dialog so that it displays the given path. |
262 * If the given path is not a directory, then do nothing. | |
263 * | |
264 * @param path The path entered in the file selection window by the user. | |
265 * @param filesel The file selection window. | |
266 * | |
267 * @return TRUE if given path is a directory, FALSE otherwise. | |
268 */ | |
269 gboolean gaim_gtk_check_if_dir(const char *path, GtkFileSelection *filesel); | |
270 | |
271 /** | |
7538
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
272 * Sets up GtkSpell for the given GtkTextView, reporting errors |
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
273 * if encountered. |
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
274 * |
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
275 * This does nothing if Gaim is not compiled with GtkSpell support. |
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
276 * |
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
277 * @param textview The textview widget to setup spellchecking for. |
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
278 */ |
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
279 void gaim_gtk_setup_gtkspell(GtkTextView *textview); |
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
280 |
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
281 /** |
5943
a4f2aba0848d
[gaim-migrate @ 6384]
Christian Hammond <chipx86@chipx86.com>
parents:
5906
diff
changeset
|
282 * Stylizes the specified text using HTML, according to the current |
a4f2aba0848d
[gaim-migrate @ 6384]
Christian Hammond <chipx86@chipx86.com>
parents:
5906
diff
changeset
|
283 * font options. |
a4f2aba0848d
[gaim-migrate @ 6384]
Christian Hammond <chipx86@chipx86.com>
parents:
5906
diff
changeset
|
284 * |
a4f2aba0848d
[gaim-migrate @ 6384]
Christian Hammond <chipx86@chipx86.com>
parents:
5906
diff
changeset
|
285 * @param text The text to stylize. |
a4f2aba0848d
[gaim-migrate @ 6384]
Christian Hammond <chipx86@chipx86.com>
parents:
5906
diff
changeset
|
286 * @param len The intended length of the new buffer. |
a4f2aba0848d
[gaim-migrate @ 6384]
Christian Hammond <chipx86@chipx86.com>
parents:
5906
diff
changeset
|
287 * |
a4f2aba0848d
[gaim-migrate @ 6384]
Christian Hammond <chipx86@chipx86.com>
parents:
5906
diff
changeset
|
288 * @return A newly allocated string of length @a len, containing the |
a4f2aba0848d
[gaim-migrate @ 6384]
Christian Hammond <chipx86@chipx86.com>
parents:
5906
diff
changeset
|
289 * stylized version of @a text. |
a4f2aba0848d
[gaim-migrate @ 6384]
Christian Hammond <chipx86@chipx86.com>
parents:
5906
diff
changeset
|
290 * |
a4f2aba0848d
[gaim-migrate @ 6384]
Christian Hammond <chipx86@chipx86.com>
parents:
5906
diff
changeset
|
291 * @todo Move this to a UI-specific file. |
a4f2aba0848d
[gaim-migrate @ 6384]
Christian Hammond <chipx86@chipx86.com>
parents:
5906
diff
changeset
|
292 */ |
a4f2aba0848d
[gaim-migrate @ 6384]
Christian Hammond <chipx86@chipx86.com>
parents:
5906
diff
changeset
|
293 char *stylize(const gchar *text, int len); |
a4f2aba0848d
[gaim-migrate @ 6384]
Christian Hammond <chipx86@chipx86.com>
parents:
5906
diff
changeset
|
294 |
7420 | 295 /** |
296 * Save menu accelerators callback | |
297 */ | |
298 void gaim_gtk_save_accels_cb(GtkAccelGroup *accel_group, guint arg1, | |
7538
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
299 GdkModifierType arg2, GClosure *arg3, |
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
300 gpointer data); |
7420 | 301 |
302 /** | |
303 * Save menu accelerators | |
304 */ | |
305 gboolean gaim_gtk_save_accels(gpointer data); | |
306 | |
307 /** | |
308 * Load menu accelerators | |
309 */ | |
310 void gaim_gtk_load_accels(); | |
311 | |
7712
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
312 /** |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
313 * Parses an application/x-im-contact MIME message and returns the |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
314 * data inside. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
315 * |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
316 * @param msg The MIME message. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
317 * @param all_accounts If TRUE, check all compatible accounts, online or |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
318 * offline. If FALSE, check only online accounts. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
319 * @param ret_account The best guess at a compatible protocol, |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
320 * based on ret_protocol. If NULL, no account was found. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
321 * @param ret_protocol The returned protocol type. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
322 * @param ret_username The returned username. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
323 * @param ret_alias The returned alias. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
324 * |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
325 * @return TRUE if the message was parsed for the minimum necessary data. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
326 * FALSE otherwise. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
327 */ |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
328 gboolean gaim_gtk_parse_x_im_contact(const char *msg, gboolean all_accounts, |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
329 GaimAccount **ret_account, |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
330 char **ret_protocol, char **ret_username, |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
331 char **ret_alias); |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
332 |
8137 | 333 /** |
334 * Sets an ATK name for a given widget. Also sets the labelled-by | |
335 * and label-for ATK relationships. | |
336 * | |
8866 | 337 * @param w The widget that we want to name. |
338 * @param l A GtkLabel that we want to use as the ATK name for the widget. | |
8137 | 339 */ |
8143 | 340 void gaim_set_accessible_label(GtkWidget *w, GtkWidget *l); |
341 | |
342 /** | |
343 * A valid GtkMenuPositionFunc. This is used to determine where | |
344 * to draw context menu's when the menu is activated with the | |
345 * keyboard (shift+F10). If the menu is activated with the mouse, | |
346 * then you should just use GTK's built-in position function, | |
347 * because it does a better job of positioning the menu. | |
348 * | |
349 * @param menu The menu we are positioning. | |
350 * @param x Address of the gint representing the horizontal position | |
351 * where the menu shall be drawn. This is an output parameter. | |
352 * @param y Address of the gint representing the vertical position | |
353 * where the menu shall be drawn. This is an output parameter. | |
354 * @param push_in This is an output parameter? | |
355 * @param user_data Not used by this particular position function. | |
356 */ | |
357 void gaim_gtk_treeview_popup_menu_position_func(GtkMenu *menu, | |
358 gint *x, | |
359 gint *y, | |
360 gboolean *push_in, | |
361 gpointer user_data); | |
8137 | 362 |
4359 | 363 #endif /* _GAIM_GTK_UTILS_H_ */ |