Mercurial > pidgin.yaz
annotate src/gtkutils.h @ 13327:b7b31c69ade6
[gaim-migrate @ 15697]
Whitespace, comments, and a warning fix
committer: Tailor Script <tailor@pidgin.im>
author | Mark Doliner <mark@kingant.net> |
---|---|
date | Sat, 25 Feb 2006 22:31:53 +0000 |
parents | 3de53fe8345f |
children | 2e6dda9f9159 |
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 /** | |
6646
b89d98f0bf79
[gaim-migrate @ 7171]
Christian Hammond <chipx86@chipx86.com>
parents:
6372
diff
changeset
|
253 * Check if the given path is a directory or not. If it is, then modify |
5966 | 254 * the given GtkFileSelection dialog so that it displays the given path. |
255 * If the given path is not a directory, then do nothing. | |
256 * | |
257 * @param path The path entered in the file selection window by the user. | |
258 * @param filesel The file selection window. | |
259 * | |
260 * @return TRUE if given path is a directory, FALSE otherwise. | |
261 */ | |
262 gboolean gaim_gtk_check_if_dir(const char *path, GtkFileSelection *filesel); | |
263 | |
264 /** | |
7538
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
265 * Sets up GtkSpell for the given GtkTextView, reporting errors |
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
266 * if encountered. |
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
267 * |
12067
e859c1663a27
[gaim-migrate @ 14362]
Richard Laager <rlaager@wiktel.com>
parents:
12061
diff
changeset
|
268 * 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
|
269 * |
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
270 * @param textview The textview widget to setup spellchecking for. |
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
271 */ |
12067
e859c1663a27
[gaim-migrate @ 14362]
Richard Laager <rlaager@wiktel.com>
parents:
12061
diff
changeset
|
272 void gaim_gtk_setup_gtkspell(GtkTextView *textview); |
7538
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
273 |
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
274 /** |
7420 | 275 * Save menu accelerators callback |
276 */ | |
277 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
|
278 GdkModifierType arg2, GClosure *arg3, |
357eb1c39b72
[gaim-migrate @ 8151]
Christian Hammond <chipx86@chipx86.com>
parents:
7420
diff
changeset
|
279 gpointer data); |
7420 | 280 |
281 /** | |
282 * Save menu accelerators | |
283 */ | |
284 gboolean gaim_gtk_save_accels(gpointer data); | |
285 | |
286 /** | |
287 * Load menu accelerators | |
288 */ | |
12323
fc464a0abccc
[gaim-migrate @ 14627]
Richard Laager <rlaager@wiktel.com>
parents:
12114
diff
changeset
|
289 void gaim_gtk_load_accels(void); |
7420 | 290 |
7712
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
291 /** |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
292 * Parses an application/x-im-contact MIME message and returns the |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
293 * data inside. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
294 * |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
295 * @param msg The MIME message. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
296 * @param all_accounts If TRUE, check all compatible accounts, online or |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
297 * offline. If FALSE, check only online accounts. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
298 * @param ret_account The best guess at a compatible protocol, |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
299 * based on ret_protocol. If NULL, no account was found. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
300 * @param ret_protocol The returned protocol type. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
301 * @param ret_username The returned username. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
302 * @param ret_alias The returned alias. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
303 * |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
304 * @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
|
305 * FALSE otherwise. |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
306 */ |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
307 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
|
308 GaimAccount **ret_account, |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
309 char **ret_protocol, char **ret_username, |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
310 char **ret_alias); |
2823111061ba
[gaim-migrate @ 8357]
Christian Hammond <chipx86@chipx86.com>
parents:
7538
diff
changeset
|
311 |
8137 | 312 /** |
313 * Sets an ATK name for a given widget. Also sets the labelled-by | |
314 * and label-for ATK relationships. | |
315 * | |
8866 | 316 * @param w The widget that we want to name. |
317 * @param l A GtkLabel that we want to use as the ATK name for the widget. | |
8137 | 318 */ |
8143 | 319 void gaim_set_accessible_label(GtkWidget *w, GtkWidget *l); |
320 | |
321 /** | |
322 * A valid GtkMenuPositionFunc. This is used to determine where | |
323 * to draw context menu's when the menu is activated with the | |
324 * keyboard (shift+F10). If the menu is activated with the mouse, | |
325 * then you should just use GTK's built-in position function, | |
326 * because it does a better job of positioning the menu. | |
327 * | |
328 * @param menu The menu we are positioning. | |
329 * @param x Address of the gint representing the horizontal position | |
330 * where the menu shall be drawn. This is an output parameter. | |
331 * @param y Address of the gint representing the vertical position | |
332 * where the menu shall be drawn. This is an output parameter. | |
333 * @param push_in This is an output parameter? | |
334 * @param user_data Not used by this particular position function. | |
335 */ | |
336 void gaim_gtk_treeview_popup_menu_position_func(GtkMenu *menu, | |
337 gint *x, | |
338 gint *y, | |
339 gboolean *push_in, | |
340 gpointer user_data); | |
8137 | 341 |
10061 | 342 /** |
10229 | 343 * Manages drag'n'drop of files. |
344 * | |
345 * @param sd GtkSelectionData for managing drag'n'drop | |
10233 | 346 * @param account Account to be used (may be NULL if conv is not NULL) |
10229 | 347 * @param who Buddy name (may be NULL if conv is not NULL) |
348 */ | |
349 void gaim_dnd_file_manage(GtkSelectionData *sd, GaimAccount *account, const char *who); | |
350 | |
10483 | 351 /** |
352 * Convenience wrapper for gaim_buddy_icon_get_scale_size | |
353 */ | |
354 void gaim_gtk_buddy_icon_get_scale_size(GdkPixbuf *buf, GaimBuddyIconSpec *spec, int *width, int *height); | |
355 | |
12080 | 356 /** |
357 * Returns the base image to represent the account, based on | |
358 * the currently selected theme. | |
359 * | |
13090 | 360 * @param account The account. |
361 * @param scale_factor The amount to scale to the original image. | |
13109 | 362 * The default size is 32x32 pixels. A scale |
13090 | 363 * factor of 1 means no scaling will be done. |
364 * A scale factor of 0.5 means the length | |
13109 | 365 * and width will be 16 pixels each. |
12080 | 366 * |
13090 | 367 * @return A newly-created pixbuf with a reference count of 1, |
368 * or NULL if any of several error conditions occurred: | |
369 * the file could not be opened, there was no loader | |
370 * for the file's format, there was not enough memory | |
371 * to allocate the image buffer, or the image file | |
372 * contained invalid data. | |
12080 | 373 */ |
13090 | 374 GdkPixbuf *gaim_gtk_create_prpl_icon(GaimAccount *account, double scale_factor); |
12080 | 375 |
376 /** | |
13090 | 377 * Create a protocol icon with the status emblem overlayed in |
378 * the lower right corner. | |
379 * | |
380 * @param account The account. | |
381 * @param status_type The status type of the emblem to overlay. | |
382 * @param scale_factor The amount to scale to the original image. | |
13109 | 383 * The default size is 32x32 pixels. A scale |
13090 | 384 * factor of 1 means no scaling will be done. |
385 * A scale factor of 0.5 means the length | |
13109 | 386 * and width will be 16 pixels each. |
12080 | 387 * |
13090 | 388 * @return A newly-created pixbuf with a reference count of 1, |
389 * or NULL if any of several error conditions occurred: | |
390 * the file could not be opened, there was no loader | |
391 * for the file's format, there was not enough memory | |
392 * to allocate the image buffer, or the image file | |
393 * contained invalid data. | |
394 */ | |
395 GdkPixbuf *gaim_gtk_create_prpl_icon_with_status(GaimAccount *account, GaimStatusType *status_type, double scale_factor); | |
396 | |
397 /** | |
398 * Create a Gaim running-man icon with the status emblem overlayed | |
399 * in the lower right corner. | |
12080 | 400 * |
13090 | 401 * @param status_type The status type to set the emblem for. |
402 * @param scale_factor The amount to scale to the original image. | |
13109 | 403 * The default size is 32x32 pixels. A scale |
13090 | 404 * factor of 1 means no scaling will be done. |
405 * A scale factor of 0.5 means the length | |
13109 | 406 * and width will be 16 pixels each. |
13090 | 407 * |
408 * @return A newly-created pixbuf with a reference count of 1, | |
409 * or NULL if any of several error conditions occurred: | |
410 * the file could not be opened, there was no loader for | |
411 * the file's format, there was not enough memory to | |
412 * allocate the image buffer, or the image file contained | |
413 * invalid data. | |
12080 | 414 */ |
13090 | 415 GdkPixbuf *gaim_gtk_create_gaim_icon_with_status(GaimStatusPrimitive primitve, double scale_factor); |
416 | |
10229 | 417 |
12919
248b8b39c671
[gaim-migrate @ 15272]
Etan Reisner <pidgin@unreliablesource.net>
parents:
12323
diff
changeset
|
418 /** |
248b8b39c671
[gaim-migrate @ 15272]
Etan Reisner <pidgin@unreliablesource.net>
parents:
12323
diff
changeset
|
419 * Append a GaimMenuAction to a menu. |
248b8b39c671
[gaim-migrate @ 15272]
Etan Reisner <pidgin@unreliablesource.net>
parents:
12323
diff
changeset
|
420 * |
248b8b39c671
[gaim-migrate @ 15272]
Etan Reisner <pidgin@unreliablesource.net>
parents:
12323
diff
changeset
|
421 * @param menu The menu to append to. |
248b8b39c671
[gaim-migrate @ 15272]
Etan Reisner <pidgin@unreliablesource.net>
parents:
12323
diff
changeset
|
422 * @param act The GaimMenuAction to append. |
248b8b39c671
[gaim-migrate @ 15272]
Etan Reisner <pidgin@unreliablesource.net>
parents:
12323
diff
changeset
|
423 * @param object The object to be passed to the action callback. |
248b8b39c671
[gaim-migrate @ 15272]
Etan Reisner <pidgin@unreliablesource.net>
parents:
12323
diff
changeset
|
424 * |
248b8b39c671
[gaim-migrate @ 15272]
Etan Reisner <pidgin@unreliablesource.net>
parents:
12323
diff
changeset
|
425 * @return The menu. |
248b8b39c671
[gaim-migrate @ 15272]
Etan Reisner <pidgin@unreliablesource.net>
parents:
12323
diff
changeset
|
426 */ |
248b8b39c671
[gaim-migrate @ 15272]
Etan Reisner <pidgin@unreliablesource.net>
parents:
12323
diff
changeset
|
427 void gaim_gtk_append_menu_action(GtkWidget *menu, GaimMenuAction *act, |
248b8b39c671
[gaim-migrate @ 15272]
Etan Reisner <pidgin@unreliablesource.net>
parents:
12323
diff
changeset
|
428 gpointer gobject); |
248b8b39c671
[gaim-migrate @ 15272]
Etan Reisner <pidgin@unreliablesource.net>
parents:
12323
diff
changeset
|
429 |
9713 | 430 #endif /* _GAIM_GTKUTILS_H_ */ |