Mercurial > pidgin
annotate src/gtkutils.h @ 5864:417b1001d2b1
[gaim-migrate @ 6295]
Rewrote the pounce API again. Now it's even MORE core/UI-split, and will
allow for loading/saving.
committer: Tailor Script <tailor@pidgin.im>
author | Christian Hammond <chipx86@chipx86.com> |
---|---|
date | Sat, 14 Jun 2003 11:14:49 +0000 |
parents | dae79aefac8d |
children | 059d95c67cda |
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 * | |
7 * Copyright (C) 2002-2003, Christian Hammond <chipx86@gnupdate.org> | |
8 * | |
9 * This program is free software; you can redistribute it and/or modify | |
10 * it under the terms of the GNU General Public License as published by | |
11 * the Free Software Foundation; either version 2 of the License, or | |
12 * (at your option) any later version. | |
13 * | |
14 * This program is distributed in the hope that it will be useful, | |
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
17 * GNU General Public License for more details. | |
18 * | |
19 * You should have received a copy of the GNU General Public License | |
20 * along with this program; if not, write to the Free Software | |
21 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA | |
22 */ | |
23 | |
24 #ifndef _GAIM_GTK_UTILS_H_ | |
25 #define _GAIM_GTK_UTILS_H_ | |
26 | |
27 #include "gaim.h" | |
28 #include "conversation.h" | |
5644
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
29 #include "prpl.h" |
4359 | 30 |
31 /** | |
32 * Sets up a gtkimhtml widget, loads it with smileys, and sets the | |
33 * default signal handlers. | |
34 * | |
35 * @param imhtml The gtkimhtml widget to setup. | |
36 */ | |
37 void gaim_setup_imhtml(GtkWidget *imhtml); | |
38 | |
39 /** | |
40 * Surrounds the selected text in a conversation with the specified | |
41 * pre and post strings. | |
42 * | |
43 * @param gtkconv The GTK+ conversation. | |
44 * @param pre The prefix string. | |
45 * @param post The postfix string. | |
46 */ | |
5676
dae79aefac8d
[gaim-migrate @ 6094]
Christian Hammond <chipx86@chipx86.com>
parents:
5644
diff
changeset
|
47 void gaim_gtk_surround(GaimGtkConversation *gtkconv, |
4359 | 48 const char *pre, const char *post); |
49 | |
50 /** | |
51 * Advances the cursor past the position of the specified tags. | |
52 * | |
53 * @param gtkconv The GTK+ conversation. | |
54 * @param pre The prefix string. | |
55 * @param post The postfix string. | |
56 */ | |
5676
dae79aefac8d
[gaim-migrate @ 6094]
Christian Hammond <chipx86@chipx86.com>
parents:
5644
diff
changeset
|
57 void gaim_gtk_advance_past(GaimGtkConversation *gtkconv, |
4359 | 58 const char *pre, const char *post); |
59 | |
60 /** | |
61 * Surrounds the selected text with the specified font. | |
62 * | |
63 * @param conv The conversation. | |
64 * @param font The new font. | |
65 */ | |
5676
dae79aefac8d
[gaim-migrate @ 6094]
Christian Hammond <chipx86@chipx86.com>
parents:
5644
diff
changeset
|
66 void gaim_gtk_set_font_face(GaimGtkConversation *gtkconv, |
4359 | 67 const char *font); |
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 /** |
5319
3adb20b869b4
[gaim-migrate @ 5691]
Christian Hammond <chipx86@chipx86.com>
parents:
5162
diff
changeset
|
113 * Toggles the sensitivity of all widgets in a pointer array. |
3adb20b869b4
[gaim-migrate @ 5691]
Christian Hammond <chipx86@chipx86.com>
parents:
5162
diff
changeset
|
114 * |
3adb20b869b4
[gaim-migrate @ 5691]
Christian Hammond <chipx86@chipx86.com>
parents:
5162
diff
changeset
|
115 * @param widget @c NULL. Used for signal handlers. |
3adb20b869b4
[gaim-migrate @ 5691]
Christian Hammond <chipx86@chipx86.com>
parents:
5162
diff
changeset
|
116 * @param to_toggle The array containing the widgets to toggle. |
3adb20b869b4
[gaim-migrate @ 5691]
Christian Hammond <chipx86@chipx86.com>
parents:
5162
diff
changeset
|
117 */ |
3adb20b869b4
[gaim-migrate @ 5691]
Christian Hammond <chipx86@chipx86.com>
parents:
5162
diff
changeset
|
118 void gtk_toggle_sensitive_array(GtkWidget *w, GPtrArray *data); |
3adb20b869b4
[gaim-migrate @ 5691]
Christian Hammond <chipx86@chipx86.com>
parents:
5162
diff
changeset
|
119 |
3adb20b869b4
[gaim-migrate @ 5691]
Christian Hammond <chipx86@chipx86.com>
parents:
5162
diff
changeset
|
120 /** |
4687 | 121 * Adds a seperator to a menu. |
122 * | |
5162 | 123 * @param menu The menu to add a seperator to. |
4687 | 124 */ |
125 void gaim_separator(GtkWidget *menu); | |
126 | |
5162 | 127 /** |
128 * Creates a menu item. | |
129 * | |
130 * @param menu The menu to which to append the menu item. | |
131 * @param str The title to use for the newly created menu item. | |
132 * | |
133 * @return The newly created menu item. | |
134 */ | |
135 GtkWidget *gaim_new_item(GtkWidget *menu, const char *str); | |
136 | |
137 /** | |
138 * Creates a menu item. | |
139 * | |
140 * @param menu The menu to which to append the menu item. | |
141 * @param str The title for the menu item. | |
5530
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
142 * @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
|
143 * or @c NULL for no icon. |
5162 | 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 accel_key Something. | |
147 * @param accel_mods Something. | |
148 * @param mod Something. | |
149 * | |
150 * @return The newly created menu item. | |
151 */ | |
5530
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
152 GtkWidget *gaim_new_item_from_stock(GtkWidget *menu, const char *str, |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
153 const char *icon, GtkSignalFunc sf, |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
154 gpointer data, guint accel_key, |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
155 guint accel_mods, char *mod); |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
156 |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
157 /** |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
158 * Creates a HIG preferences frame. |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
159 * |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
160 * @param parent The widget to put the frame into. |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
161 * @param title The title for the frame. |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
162 * |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
163 * @return The vbox to put things into. |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
164 */ |
2c4c975620f0
[gaim-migrate @ 5930]
Christian Hammond <chipx86@chipx86.com>
parents:
5319
diff
changeset
|
165 GtkWidget *gaim_gtk_make_frame(GtkWidget *parent, const char *title); |
5162 | 166 |
5644
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
167 /** |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
168 * Creates a drop-down option menu filled with protocols. |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
169 * |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
170 * @param protocol The protocol to select by default. |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
171 * @param cb The callback to call when a protocol is selected. |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
172 * @param user_data Data to pass to the callback function. |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
173 * |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
174 * @return The drop-down option menu. |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
175 */ |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
176 GtkWidget *gaim_gtk_protocol_option_menu_new(GaimProtocol protocol, |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
177 GCallback cb, |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
178 gpointer user_data); |
213e999fa5cc
[gaim-migrate @ 6058]
Christian Hammond <chipx86@chipx86.com>
parents:
5530
diff
changeset
|
179 |
4359 | 180 #endif /* _GAIM_GTK_UTILS_H_ */ |