Mercurial > pidgin
annotate src/gtkutils.h @ 13967:99b9b58b19dd
[gaim-migrate @ 16523]
Fix a crazy MSN crash. Basically it's possible to have more than one
slplink associated with a given switchboard, but our code did not
allow for that. I think it happens when you're in a multi-user
chat and you do stuff with multiple users that involves slplinks.
Like maybe file transfer and buddy icon related stuff.
Tracking this down took an ungodly amount of time, but thanks to
Meebo for letting me do it :-)
committer: Tailor Script <tailor@pidgin.im>
author | Mark Doliner <mark@kingant.net> |
---|---|
date | Thu, 20 Jul 2006 07:31:15 +0000 |
parents | 853fefb07c79 |
children | 31d33e7bc0e6 |
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 */ | |
9713 | 25 #ifndef _GAIM_GTKUTILS_H_ |
26 #define _GAIM_GTKUTILS_H_ | |
4359 | 27 |
5872
059d95c67cda
[gaim-migrate @ 6304]
Christian Hammond <chipx86@chipx86.com>
parents:
5676
diff
changeset
|
28 #include "gtkconv.h" |
9791 | 29 #include "gtkgaim.h" |
5644
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
30 #include "prpl.h" |
12919
248b8b39c671
[gaim-migrate @ 15272]
Etan Reisner <pidgin@unreliablesource.net>
parents:
12323
diff
changeset
|
31 #include "util.h" |
4359 | 32 |
6372
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
33 typedef enum |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
34 { |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
35 GAIM_BUTTON_HORIZONTAL, |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
36 GAIM_BUTTON_VERTICAL |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
37 |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
38 } GaimButtonOrientation; |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
39 |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
40 typedef enum |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
41 { |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
42 GAIM_BUTTON_NONE = 0, |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
43 GAIM_BUTTON_TEXT, |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
44 GAIM_BUTTON_IMAGE, |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
45 GAIM_BUTTON_TEXT_IMAGE |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
46 |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
47 } GaimButtonStyle; |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
48 |
8272 | 49 #ifndef _WIN32 |
50 typedef enum | |
51 { | |
52 GAIM_BROWSER_DEFAULT = 0, | |
53 GAIM_BROWSER_CURRENT, | |
54 GAIM_BROWSER_NEW_WINDOW, | |
55 GAIM_BROWSER_NEW_TAB | |
8741
b994b0223335
[gaim-migrate @ 9496]
Christian Hammond <chipx86@chipx86.com>
parents:
8735
diff
changeset
|
56 |
8272 | 57 } GaimBrowserPlace; |
58 #endif /* _WIN32 */ | |
59 | |
4359 | 60 /** |
61 * Sets up a gtkimhtml widget, loads it with smileys, and sets the | |
62 * default signal handlers. | |
63 * | |
64 * @param imhtml The gtkimhtml widget to setup. | |
65 */ | |
66 void gaim_setup_imhtml(GtkWidget *imhtml); | |
67 | |
68 /** | |
10175 | 69 * Create an GtkIMHtml widget and associated GtkIMHtmlToolbar widget. This |
70 * functions puts both widgets in a nice GtkFrame. They're separate by an | |
71 * attractive GtkSeparator. | |
72 * | |
13280
3de53fe8345f
[gaim-migrate @ 15646]
Richard Laager <rlaager@wiktel.com>
parents:
13109
diff
changeset
|
73 * @param editable @c TRUE if this imhtml should be editable. If this is @c FALSE, |
10175 | 74 * then the toolbar will NOT be created. If this imthml should be |
75 * read-only at first, but may become editable later, then pass in | |
13280
3de53fe8345f
[gaim-migrate @ 15646]
Richard Laager <rlaager@wiktel.com>
parents:
13109
diff
changeset
|
76 * @c TRUE here and then manually call gtk_imhtml_set_editable() later. |
10175 | 77 * @param imhtml_ret A pointer to a pointer to a GtkWidget. This pointer |
78 * will be set to the imhtml when this function exits. | |
79 * @param toolbar_ret A pointer to a pointer to a GtkWidget. If editable is | |
80 * TRUE then this will be set to the toolbar when this function exits. | |
13280
3de53fe8345f
[gaim-migrate @ 15646]
Richard Laager <rlaager@wiktel.com>
parents:
13109
diff
changeset
|
81 * Otherwise this will be set to @c NULL. |
3de53fe8345f
[gaim-migrate @ 15646]
Richard Laager <rlaager@wiktel.com>
parents:
13109
diff
changeset
|
82 * @param sw_ret This will be filled with a pointer to the scrolled window |
3de53fe8345f
[gaim-migrate @ 15646]
Richard Laager <rlaager@wiktel.com>
parents:
13109
diff
changeset
|
83 * widget which contains the imhtml. |
10175 | 84 * @return The GtkFrame containing the toolbar and imhtml. |
85 */ | |
13280
3de53fe8345f
[gaim-migrate @ 15646]
Richard Laager <rlaager@wiktel.com>
parents:
13109
diff
changeset
|
86 GtkWidget *gaim_gtk_create_imhtml(gboolean editable, GtkWidget **imhtml_ret, GtkWidget **toolbar_ret, GtkWidget **sw_ret); |
10175 | 87 |
88 /** | |
4359 | 89 * Toggles the sensitivity of a widget. |
90 * | |
91 * @param widget @c NULL. Used for signal handlers. | |
92 * @param to_toggle The widget to toggle. | |
93 */ | |
94 void gaim_gtk_toggle_sensitive(GtkWidget *widget, GtkWidget *to_toggle); | |
95 | |
4687 | 96 /** |
7751 | 97 * Checks if text has been entered into a GtkTextEntry widget. If |
98 * so, the GTK_RESPONSE_OK on the given dialog is set to TRUE. | |
99 * Otherwise GTK_RESPONSE_OK is set to FALSE. | |
100 * | |
101 * @param entry The text entry widget. | |
102 * @param dialog The dialog containing the text entry widget. | |
103 */ | |
104 void gaim_gtk_set_sensitive_if_input(GtkWidget *entry, GtkWidget *dialog); | |
105 | |
106 /** | |
5319
3adb20b869b4
[gaim-migrate @ 5691]
Christian Hammond <chipx86@chipx86.com>
parents:
5162
diff
changeset
|
107 * Toggles the sensitivity of all widgets in a pointer array. |
3adb20b869b4
[gaim-migrate @ 5691]
Christian Hammond <chipx86@chipx86.com>
parents:
5162
diff
changeset
|
108 * |
6720
41120df7ed94
[gaim-migrate @ 7247]
Christian Hammond <chipx86@chipx86.com>
parents:
6646
diff
changeset
|
109 * @param w @c NULL. Used for signal handlers. |
41120df7ed94
[gaim-migrate @ 7247]
Christian Hammond <chipx86@chipx86.com>
parents:
6646
diff
changeset
|
110 * @param data The array containing the widgets to toggle. |
5319
3adb20b869b4
[gaim-migrate @ 5691]
Christian Hammond <chipx86@chipx86.com>
parents:
5162
diff
changeset
|
111 */ |
10590
896efbdc74e2
[gaim-migrate @ 11995]
Etan Reisner <pidgin@unreliablesource.net>
parents:
10483
diff
changeset
|
112 void gaim_gtk_toggle_sensitive_array(GtkWidget *w, GPtrArray *data); |
5319
3adb20b869b4
[gaim-migrate @ 5691]
Christian Hammond <chipx86@chipx86.com>
parents:
5162
diff
changeset
|
113 |
3adb20b869b4
[gaim-migrate @ 5691]
Christian Hammond <chipx86@chipx86.com>
parents:
5162
diff
changeset
|
114 /** |
8901 | 115 * Toggles the visibility of a widget. |
116 * | |
117 * @param widget @c NULL. Used for signal handlers. | |
118 * @param to_toggle The widget to toggle. | |
119 */ | |
120 void gaim_gtk_toggle_showhide(GtkWidget *widget, GtkWidget *to_toggle); | |
121 | |
122 /** | |
8735
92cbf9713795
[gaim-migrate @ 9490]
Christian Hammond <chipx86@chipx86.com>
parents:
8289
diff
changeset
|
123 * Adds a separator to a menu. |
4687 | 124 * |
8735
92cbf9713795
[gaim-migrate @ 9490]
Christian Hammond <chipx86@chipx86.com>
parents:
8289
diff
changeset
|
125 * @param menu The menu to add a separator to. |
4687 | 126 */ |
127 void gaim_separator(GtkWidget *menu); | |
128 | |
5162 | 129 /** |
130 * Creates a menu item. | |
131 * | |
132 * @param menu The menu to which to append the menu item. | |
133 * @param str The title to use for the newly created menu item. | |
134 * | |
135 * @return The newly created menu item. | |
136 */ | |
5906 | 137 GtkWidget *gaim_new_item(GtkWidget *menu, const char *str); |
138 | |
139 /** | |
140 * Creates a check menu item. | |
141 * | |
142 * @param menu The menu to which to append the check menu item. | |
143 * @param str The title to use for the newly created menu item. | |
144 * @param sf A function to call when the menu item is activated. | |
145 * @param data Data to pass to the signal function. | |
146 * @param checked The initial state of the check item | |
147 * | |
148 * @return The newly created menu item. | |
149 */ | |
150 GtkWidget *gaim_new_check_item(GtkWidget *menu, const char *str, | |
151 GtkSignalFunc sf, gpointer data, gboolean checked); | |
5162 | 152 |
153 /** | |
154 * Creates a menu item. | |
155 * | |
156 * @param menu The menu to which to append the menu item. | |
157 * @param str The title for the menu item. | |
5530
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
158 * @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
|
159 * or @c NULL for no icon. |
5162 | 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 accel_key Something. | |
163 * @param accel_mods Something. | |
164 * @param mod Something. | |
165 * | |
166 * @return The newly created menu item. | |
167 */ | |
5530
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
168 GtkWidget *gaim_new_item_from_stock(GtkWidget *menu, const char *str, |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
169 const char *icon, GtkSignalFunc sf, |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
170 gpointer data, guint accel_key, |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
171 guint accel_mods, char *mod); |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
172 |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
173 /** |
6372
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
174 * Creates a button with the specified text and stock icon. |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
175 * |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
176 * @param text The text for the button. |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
177 * @param icon The stock icon name. |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
178 * @param style The orientation of the button. |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
179 * |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
180 * @return The button. |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
181 */ |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
182 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
|
183 GaimButtonOrientation style); |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
184 |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
185 /** |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
186 * Creates a toolbar button with the stock icon. |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
187 * |
6720
41120df7ed94
[gaim-migrate @ 7247]
Christian Hammond <chipx86@chipx86.com>
parents:
6646
diff
changeset
|
188 * @param stock The stock icon name. |
6372
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
189 * |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
190 * @return The button. |
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 GtkWidget *gaim_pixbuf_toolbar_button_from_stock(const char *stock); |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
193 |
9dd4bb3cf1df
[gaim-migrate @ 6877]
Christian Hammond <chipx86@chipx86.com>
parents:
5966
diff
changeset
|
194 /** |
5530
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
195 * Creates a HIG preferences frame. |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
196 * |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
197 * @param parent The widget to put the frame into. |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
198 * @param title The title for the frame. |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
199 * |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
200 * @return The vbox to put things into. |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
201 */ |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
202 GtkWidget *gaim_gtk_make_frame(GtkWidget *parent, const char *title); |
5162 | 203 |
5644
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
204 /** |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
205 * Creates a drop-down option menu filled with protocols. |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
206 * |
7956 | 207 * @param id The protocol to select by default. |
5644
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
208 * @param cb The callback to call when a protocol is selected. |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
209 * @param user_data Data to pass to the callback function. |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
210 * |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
211 * @return The drop-down option menu. |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
212 */ |
7956 | 213 GtkWidget *gaim_gtk_protocol_option_menu_new(const char *id, |
5644
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
214 GCallback cb, |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
215 gpointer user_data); |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
216 |
5877
f336fc0a7b8b
[gaim-migrate @ 6309]
Christian Hammond <chipx86@chipx86.com>
parents:
5872
diff
changeset
|
217 /** |
f336fc0a7b8b
[gaim-migrate @ 6309]
Christian Hammond <chipx86@chipx86.com>
parents:
5872
diff
changeset
|
218 * Creates a drop-down option menu filled with accounts. |
f336fc0a7b8b
[gaim-migrate @ 6309]
Christian Hammond <chipx86@chipx86.com>
parents:
5872
diff
changeset
|
219 * |
8289
e39ea2b4f6cd
[gaim-migrate @ 9013]
Christian Hammond <chipx86@chipx86.com>
parents:
8272
diff
changeset
|
220 * @param default_account The account to select by default. |
e39ea2b4f6cd
[gaim-migrate @ 9013]
Christian Hammond <chipx86@chipx86.com>
parents:
8272
diff
changeset
|
221 * @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
|
222 * active accounts. |
e39ea2b4f6cd
[gaim-migrate @ 9013]
Christian Hammond <chipx86@chipx86.com>
parents:
8272
diff
changeset
|
223 * @param cb The callback to call when an account is selected. |
e39ea2b4f6cd
[gaim-migrate @ 9013]
Christian Hammond <chipx86@chipx86.com>
parents:
8272
diff
changeset
|
224 * @param filter_func A function for checking if an account should |
e39ea2b4f6cd
[gaim-migrate @ 9013]
Christian Hammond <chipx86@chipx86.com>
parents:
8272
diff
changeset
|
225 * be shown. This can be NULL. |
e39ea2b4f6cd
[gaim-migrate @ 9013]
Christian Hammond <chipx86@chipx86.com>
parents:
8272
diff
changeset
|
226 * @param user_data Data to pass to the callback function. |
5877
f336fc0a7b8b
[gaim-migrate @ 6309]
Christian Hammond <chipx86@chipx86.com>
parents:
5872
diff
changeset
|
227 * |
f336fc0a7b8b
[gaim-migrate @ 6309]
Christian Hammond <chipx86@chipx86.com>
parents:
5872
diff
changeset
|
228 * @return The drop-down option menu. |
f336fc0a7b8b
[gaim-migrate @ 6309]
Christian Hammond <chipx86@chipx86.com>
parents:
5872
diff
changeset
|
229 */ |
f336fc0a7b8b
[gaim-migrate @ 6309]
Christian Hammond <chipx86@chipx86.com>
parents:
5872
diff
changeset
|
230 GtkWidget *gaim_gtk_account_option_menu_new(GaimAccount *default_account, |
6646
b89d98f0bf79
[gaim-migrate @ 7171]
Christian Hammond <chipx86@chipx86.com>
parents:
6372
diff
changeset
|
231 gboolean show_all, GCallback cb, |
8289
e39ea2b4f6cd
[gaim-migrate @ 9013]
Christian Hammond <chipx86@chipx86.com>
parents:
8272
diff
changeset
|
232 GaimFilterAccountFunc filter_func, gpointer user_data); |
5877
f336fc0a7b8b
[gaim-migrate @ 6309]
Christian Hammond <chipx86@chipx86.com>
parents:
5872
diff
changeset
|
233 |
5943
a4f2aba0848d
[gaim-migrate @ 6384]
Christian Hammond <chipx86@chipx86.com>
parents:
5906
diff
changeset
|
234 /** |
8940 | 235 * Gets the currently selected account from an account drop down box. |
236 * | |
237 * @param optmenu The GtkOptionMenu created by | |
238 * gaim_gtk_account_option_menu_new. | |
239 * @return Returns the GaimAccount that is currently selected. | |
240 */ | |
241 GaimAccount *gaim_gtk_account_option_menu_get_selected(GtkWidget *optmenu); | |
242 | |
243 /** | |
9910 | 244 * Sets the currently selected account for an account drop down box. |
245 * | |
246 * @param optmenu The GtkOptionMenu created by | |
247 * gaim_gtk_account_option_menu_new. | |
248 * @param account The GaimAccount to select. | |
249 */ | |
250 void gaim_gtk_account_option_menu_set_selected(GtkWidget *optmenu, GaimAccount *account); | |
251 | |
252 /** | |
13360
2e6dda9f9159
[gaim-migrate @ 15733]
Richard Laager <rlaager@wiktel.com>
parents:
13280
diff
changeset
|
253 * Add autocompletion of screenames to an entry. |
2e6dda9f9159
[gaim-migrate @ 15733]
Richard Laager <rlaager@wiktel.com>
parents:
13280
diff
changeset
|
254 * |
2e6dda9f9159
[gaim-migrate @ 15733]
Richard Laager <rlaager@wiktel.com>
parents:
13280
diff
changeset
|
255 * @param entry The GtkEntry on which to setup autocomplete. |
2e6dda9f9159
[gaim-migrate @ 15733]
Richard Laager <rlaager@wiktel.com>
parents:
13280
diff
changeset
|
256 * @param optmenu A menu for accounts, returned by gaim_gtk_account_option_menu_new(). |
2e6dda9f9159
[gaim-migrate @ 15733]
Richard Laager <rlaager@wiktel.com>
parents:
13280
diff
changeset
|
257 * If @a optmenu is not @c NULL, it'll be updated when a screenname is chosen |
2e6dda9f9159
[gaim-migrate @ 15733]
Richard Laager <rlaager@wiktel.com>
parents:
13280
diff
changeset
|
258 * from the autocomplete list. |
2e6dda9f9159
[gaim-migrate @ 15733]
Richard Laager <rlaager@wiktel.com>
parents:
13280
diff
changeset
|
259 * @param all Whether to include screennames from disconnected accounts. |
2e6dda9f9159
[gaim-migrate @ 15733]
Richard Laager <rlaager@wiktel.com>
parents:
13280
diff
changeset
|
260 */ |
2e6dda9f9159
[gaim-migrate @ 15733]
Richard Laager <rlaager@wiktel.com>
parents:
13280
diff
changeset
|
261 void gaim_gtk_setup_screenname_autocomplete(GtkWidget *entry, GtkWidget *optmenu, gboolean all); |
2e6dda9f9159
[gaim-migrate @ 15733]
Richard Laager <rlaager@wiktel.com>
parents:
13280
diff
changeset
|
262 |
2e6dda9f9159
[gaim-migrate @ 15733]
Richard Laager <rlaager@wiktel.com>
parents:
13280
diff
changeset
|
263 /** |
6646
b89d98f0bf79
[gaim-migrate @ 7171]
Christian Hammond <chipx86@chipx86.com>
parents:
6372
diff
changeset
|
264 * Check if the given path is a directory or not. If it is, then modify |
5966 | 265 * the given GtkFileSelection dialog so that it displays the given path. |
266 * If the given path is not a directory, then do nothing. | |
267 * | |
268 * @param path The path entered in the file selection window by the user. | |
269 * @param filesel The file selection window. | |
270 * | |
271 * @return TRUE if given path is a directory, FALSE otherwise. | |
272 */ | |
273 gboolean gaim_gtk_check_if_dir(const char *path, GtkFileSelection *filesel); | |
274 | |
275 /** | |
7538
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
276 * Sets up GtkSpell for the given GtkTextView, reporting errors |
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
277 * if encountered. |
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
278 * |
12067
e859c1663a27
[gaim-migrate @ 14362]
Richard Laager <rlaager@wiktel.com>
parents:
12061
diff
changeset
|
279 * This does nothing if Gaim is not compiled with GtkSpell support. |
7538
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 * @param textview The textview widget to setup spellchecking for. |
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
282 */ |
12067
e859c1663a27
[gaim-migrate @ 14362]
Richard Laager <rlaager@wiktel.com>
parents:
12061
diff
changeset
|
283 void gaim_gtk_setup_gtkspell(GtkTextView *textview); |
7538
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
284 |
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
285 /** |
7420 | 286 * Save menu accelerators callback |
287 */ | |
288 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
|
289 GdkModifierType arg2, GClosure *arg3, |
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
290 gpointer data); |
7420 | 291 |
292 /** | |
293 * Save menu accelerators | |
294 */ | |
295 gboolean gaim_gtk_save_accels(gpointer data); | |
296 | |
297 /** | |
298 * Load menu accelerators | |
299 */ | |
12323
fc464a0abccc
[gaim-migrate @ 14627]
Richard Laager <rlaager@wiktel.com>
parents:
12114
diff
changeset
|
300 void gaim_gtk_load_accels(void); |
7420 | 301 |
7712
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
302 /** |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
303 * Parses an application/x-im-contact MIME message and returns the |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
304 * data inside. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
305 * |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
306 * @param msg The MIME message. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
307 * @param all_accounts If TRUE, check all compatible accounts, online or |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
308 * offline. If FALSE, check only online accounts. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
309 * @param ret_account The best guess at a compatible protocol, |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
310 * based on ret_protocol. If NULL, no account was found. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
311 * @param ret_protocol The returned protocol type. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
312 * @param ret_username The returned username. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
313 * @param ret_alias The returned alias. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
314 * |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
315 * @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
|
316 * FALSE otherwise. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
317 */ |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
318 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
|
319 GaimAccount **ret_account, |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
320 char **ret_protocol, char **ret_username, |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
321 char **ret_alias); |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
322 |
8137 | 323 /** |
324 * Sets an ATK name for a given widget. Also sets the labelled-by | |
325 * and label-for ATK relationships. | |
326 * | |
8866 | 327 * @param w The widget that we want to name. |
328 * @param l A GtkLabel that we want to use as the ATK name for the widget. | |
8137 | 329 */ |
8143 | 330 void gaim_set_accessible_label(GtkWidget *w, GtkWidget *l); |
331 | |
332 /** | |
333 * A valid GtkMenuPositionFunc. This is used to determine where | |
334 * to draw context menu's when the menu is activated with the | |
335 * keyboard (shift+F10). If the menu is activated with the mouse, | |
336 * then you should just use GTK's built-in position function, | |
337 * because it does a better job of positioning the menu. | |
338 * | |
339 * @param menu The menu we are positioning. | |
340 * @param x Address of the gint representing the horizontal position | |
341 * where the menu shall be drawn. This is an output parameter. | |
342 * @param y Address of the gint representing the vertical position | |
343 * where the menu shall be drawn. This is an output parameter. | |
344 * @param push_in This is an output parameter? | |
345 * @param user_data Not used by this particular position function. | |
346 */ | |
347 void gaim_gtk_treeview_popup_menu_position_func(GtkMenu *menu, | |
348 gint *x, | |
349 gint *y, | |
350 gboolean *push_in, | |
351 gpointer user_data); | |
8137 | 352 |
10061 | 353 /** |
10229 | 354 * Manages drag'n'drop of files. |
355 * | |
356 * @param sd GtkSelectionData for managing drag'n'drop | |
10233 | 357 * @param account Account to be used (may be NULL if conv is not NULL) |
10229 | 358 * @param who Buddy name (may be NULL if conv is not NULL) |
359 */ | |
360 void gaim_dnd_file_manage(GtkSelectionData *sd, GaimAccount *account, const char *who); | |
361 | |
10483 | 362 /** |
363 * Convenience wrapper for gaim_buddy_icon_get_scale_size | |
364 */ | |
365 void gaim_gtk_buddy_icon_get_scale_size(GdkPixbuf *buf, GaimBuddyIconSpec *spec, int *width, int *height); | |
366 | |
12080 | 367 /** |
368 * Returns the base image to represent the account, based on | |
369 * the currently selected theme. | |
370 * | |
13090 | 371 * @param account The account. |
372 * @param scale_factor The amount to scale to the original image. | |
13109 | 373 * The default size is 32x32 pixels. A scale |
13090 | 374 * factor of 1 means no scaling will be done. |
375 * A scale factor of 0.5 means the length | |
13109 | 376 * and width will be 16 pixels each. |
12080 | 377 * |
13090 | 378 * @return A newly-created pixbuf with a reference count of 1, |
379 * or NULL if any of several error conditions occurred: | |
380 * the file could not be opened, there was no loader | |
381 * for the file's format, there was not enough memory | |
382 * to allocate the image buffer, or the image file | |
383 * contained invalid data. | |
12080 | 384 */ |
13090 | 385 GdkPixbuf *gaim_gtk_create_prpl_icon(GaimAccount *account, double scale_factor); |
12080 | 386 |
387 /** | |
13090 | 388 * Create a protocol icon with the status emblem overlayed in |
389 * the lower right corner. | |
390 * | |
391 * @param account The account. | |
392 * @param status_type The status type of the emblem to overlay. | |
393 * @param scale_factor The amount to scale to the original image. | |
13109 | 394 * The default size is 32x32 pixels. A scale |
13090 | 395 * factor of 1 means no scaling will be done. |
396 * A scale factor of 0.5 means the length | |
13109 | 397 * and width will be 16 pixels each. |
12080 | 398 * |
13090 | 399 * @return A newly-created pixbuf with a reference count of 1, |
400 * or NULL if any of several error conditions occurred: | |
401 * the file could not be opened, there was no loader | |
402 * for the file's format, there was not enough memory | |
403 * to allocate the image buffer, or the image file | |
404 * contained invalid data. | |
405 */ | |
406 GdkPixbuf *gaim_gtk_create_prpl_icon_with_status(GaimAccount *account, GaimStatusType *status_type, double scale_factor); | |
407 | |
408 /** | |
409 * Create a Gaim running-man icon with the status emblem overlayed | |
410 * in the lower right corner. | |
12080 | 411 * |
13783
a539caf502b0
[gaim-migrate @ 16195]
Richard Laager <rlaager@wiktel.com>
parents:
13469
diff
changeset
|
412 * @param primitive The status type to set the emblem for. |
13090 | 413 * @param scale_factor The amount to scale to the original image. |
13109 | 414 * The default size is 32x32 pixels. A scale |
13090 | 415 * factor of 1 means no scaling will be done. |
416 * A scale factor of 0.5 means the length | |
13109 | 417 * and width will be 16 pixels each. |
13090 | 418 * |
419 * @return A newly-created pixbuf with a reference count of 1, | |
420 * or NULL if any of several error conditions occurred: | |
421 * the file could not be opened, there was no loader for | |
422 * the file's format, there was not enough memory to | |
423 * allocate the image buffer, or the image file contained | |
424 * invalid data. | |
12080 | 425 */ |
13783
a539caf502b0
[gaim-migrate @ 16195]
Richard Laager <rlaager@wiktel.com>
parents:
13469
diff
changeset
|
426 GdkPixbuf *gaim_gtk_create_gaim_icon_with_status(GaimStatusPrimitive primitive, double scale_factor); |
13090 | 427 |
10229 | 428 |
12919
248b8b39c671
[gaim-migrate @ 15272]
Etan Reisner <pidgin@unreliablesource.net>
parents:
12323
diff
changeset
|
429 /** |
248b8b39c671
[gaim-migrate @ 15272]
Etan Reisner <pidgin@unreliablesource.net>
parents:
12323
diff
changeset
|
430 * Append a GaimMenuAction to a menu. |
248b8b39c671
[gaim-migrate @ 15272]
Etan Reisner <pidgin@unreliablesource.net>
parents:
12323
diff
changeset
|
431 * |
13783
a539caf502b0
[gaim-migrate @ 16195]
Richard Laager <rlaager@wiktel.com>
parents:
13469
diff
changeset
|
432 * @param menu The menu to append to. |
a539caf502b0
[gaim-migrate @ 16195]
Richard Laager <rlaager@wiktel.com>
parents:
13469
diff
changeset
|
433 * @param act The GaimMenuAction to append. |
a539caf502b0
[gaim-migrate @ 16195]
Richard Laager <rlaager@wiktel.com>
parents:
13469
diff
changeset
|
434 * @param gobject The object to be passed to the action callback. |
12919
248b8b39c671
[gaim-migrate @ 15272]
Etan Reisner <pidgin@unreliablesource.net>
parents:
12323
diff
changeset
|
435 */ |
248b8b39c671
[gaim-migrate @ 15272]
Etan Reisner <pidgin@unreliablesource.net>
parents:
12323
diff
changeset
|
436 void gaim_gtk_append_menu_action(GtkWidget *menu, GaimMenuAction *act, |
248b8b39c671
[gaim-migrate @ 15272]
Etan Reisner <pidgin@unreliablesource.net>
parents:
12323
diff
changeset
|
437 gpointer gobject); |
248b8b39c671
[gaim-migrate @ 15272]
Etan Reisner <pidgin@unreliablesource.net>
parents:
12323
diff
changeset
|
438 |
13434
ffd724befbf8
[gaim-migrate @ 15809]
Richard Laager <rlaager@wiktel.com>
parents:
13360
diff
changeset
|
439 /** |
ffd724befbf8
[gaim-migrate @ 15809]
Richard Laager <rlaager@wiktel.com>
parents:
13360
diff
changeset
|
440 * Sets the mouse pointer for a GtkWidget. |
ffd724befbf8
[gaim-migrate @ 15809]
Richard Laager <rlaager@wiktel.com>
parents:
13360
diff
changeset
|
441 * |
ffd724befbf8
[gaim-migrate @ 15809]
Richard Laager <rlaager@wiktel.com>
parents:
13360
diff
changeset
|
442 * After setting the cursor, the display is flushed, so the change will |
ffd724befbf8
[gaim-migrate @ 15809]
Richard Laager <rlaager@wiktel.com>
parents:
13360
diff
changeset
|
443 * take effect immediately. |
ffd724befbf8
[gaim-migrate @ 15809]
Richard Laager <rlaager@wiktel.com>
parents:
13360
diff
changeset
|
444 * |
13469
689f652480f7
[gaim-migrate @ 15845]
Richard Laager <rlaager@wiktel.com>
parents:
13434
diff
changeset
|
445 * If the window for @a widget is @c NULL, this function simply returns. |
13434
ffd724befbf8
[gaim-migrate @ 15809]
Richard Laager <rlaager@wiktel.com>
parents:
13360
diff
changeset
|
446 * |
ffd724befbf8
[gaim-migrate @ 15809]
Richard Laager <rlaager@wiktel.com>
parents:
13360
diff
changeset
|
447 * @param widget The widget for which to set the mouse pointer |
ffd724befbf8
[gaim-migrate @ 15809]
Richard Laager <rlaager@wiktel.com>
parents:
13360
diff
changeset
|
448 * @param cursor_type The type of cursor to set |
ffd724befbf8
[gaim-migrate @ 15809]
Richard Laager <rlaager@wiktel.com>
parents:
13360
diff
changeset
|
449 */ |
ffd724befbf8
[gaim-migrate @ 15809]
Richard Laager <rlaager@wiktel.com>
parents:
13360
diff
changeset
|
450 void gaim_gtk_set_cursor(GtkWidget *widget, GdkCursorType cursor_type); |
ffd724befbf8
[gaim-migrate @ 15809]
Richard Laager <rlaager@wiktel.com>
parents:
13360
diff
changeset
|
451 |
ffd724befbf8
[gaim-migrate @ 15809]
Richard Laager <rlaager@wiktel.com>
parents:
13360
diff
changeset
|
452 /** |
ffd724befbf8
[gaim-migrate @ 15809]
Richard Laager <rlaager@wiktel.com>
parents:
13360
diff
changeset
|
453 * Sets the mouse point for a GtkWidget back to that of its parent window. |
ffd724befbf8
[gaim-migrate @ 15809]
Richard Laager <rlaager@wiktel.com>
parents:
13360
diff
changeset
|
454 * |
ffd724befbf8
[gaim-migrate @ 15809]
Richard Laager <rlaager@wiktel.com>
parents:
13360
diff
changeset
|
455 * If @a widget is @c NULL, this function simply returns. |
ffd724befbf8
[gaim-migrate @ 15809]
Richard Laager <rlaager@wiktel.com>
parents:
13360
diff
changeset
|
456 * |
13469
689f652480f7
[gaim-migrate @ 15845]
Richard Laager <rlaager@wiktel.com>
parents:
13434
diff
changeset
|
457 * If the window for @a widget is @c NULL, this function simply returns. |
13434
ffd724befbf8
[gaim-migrate @ 15809]
Richard Laager <rlaager@wiktel.com>
parents:
13360
diff
changeset
|
458 * |
ffd724befbf8
[gaim-migrate @ 15809]
Richard Laager <rlaager@wiktel.com>
parents:
13360
diff
changeset
|
459 * @note The display is not flushed from this function. |
ffd724befbf8
[gaim-migrate @ 15809]
Richard Laager <rlaager@wiktel.com>
parents:
13360
diff
changeset
|
460 */ |
ffd724befbf8
[gaim-migrate @ 15809]
Richard Laager <rlaager@wiktel.com>
parents:
13360
diff
changeset
|
461 void gaim_gtk_clear_cursor(GtkWidget *widget); |
ffd724befbf8
[gaim-migrate @ 15809]
Richard Laager <rlaager@wiktel.com>
parents:
13360
diff
changeset
|
462 |
9713 | 463 #endif /* _GAIM_GTKUTILS_H_ */ |