Mercurial > pidgin
annotate src/gtkconv.h @ 10532:8f2b74c5aa24
[gaim-migrate @ 11860]
The text replacement now sorts entries alphabetically thanks Richard Laager.
committer: Tailor Script <tailor@pidgin.im>
author | Etan Reisner <pidgin@unreliablesource.net> |
---|---|
date | Thu, 20 Jan 2005 14:40:56 +0000 |
parents | 6ec5da82ef41 |
children | 9a1ced2bc585 |
rev | line source |
---|---|
4359 | 1 /** |
2 * @file gtkconv.h GTK+ Conversation API | |
5034
4691c5936c01
[gaim-migrate @ 5377]
Christian Hammond <chipx86@chipx86.com>
parents:
4736
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. | |
7326
00a9ab26d607
[gaim-migrate @ 7912]
Christian Hammond <chipx86@chipx86.com>
parents:
7295
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_GTKCONVERSATION_H_ |
26 #define _GAIM_GTKCONVERSATION_H_ | |
4359 | 27 |
10008 | 28 typedef struct _GaimGtkWindow GaimGtkWindow; |
29 typedef struct _GaimGtkImPane GaimGtkImPane; | |
30 typedef struct _GaimGtkChatPane GaimGtkChatPane; | |
31 typedef struct _GaimGtkConversation GaimGtkConversation; | |
9709 | 32 |
9498 | 33 enum { |
34 CHAT_USERS_ICON_COLUMN, | |
35 CHAT_USERS_NAME_COLUMN, | |
9554 | 36 CHAT_USERS_FLAGS_COLUMN, |
9498 | 37 CHAT_USERS_COLUMNS |
38 }; | |
39 | |
10008 | 40 #define GAIM_GTK_WINDOW(win) \ |
41 ((GaimGtkWindow *)(win)->ui_data) | |
42 | |
43 #define GAIM_GTK_CONVERSATION(conv) \ | |
44 ((GaimGtkConversation *)(conv)->ui_data) | |
45 | |
46 #define GAIM_IS_GTK_WINDOW(win) \ | |
47 (gaim_conv_window_get_ui_ops(win) == gaim_gtk_conversations_get_win_ui_ops()) | |
48 | |
49 #define GAIM_IS_GTK_CONVERSATION(conv) \ | |
50 (gaim_conversation_get_ui_ops(conv) == \ | |
51 gaim_gtk_conversations_get_conv_ui_ops()) | |
52 | |
53 #include "gtkgaim.h" | |
54 #include "conversation.h" | |
55 | |
4359 | 56 /************************************************************************** |
57 * @name Structures | |
58 **************************************************************************/ | |
5676
dae79aefac8d
[gaim-migrate @ 6094]
Christian Hammond <chipx86@chipx86.com>
parents:
5674
diff
changeset
|
59 /*@{*/ |
4359 | 60 |
61 /** | |
62 * A GTK+ representation of a graphical window containing one or more | |
63 * conversations. | |
64 */ | |
5676
dae79aefac8d
[gaim-migrate @ 6094]
Christian Hammond <chipx86@chipx86.com>
parents:
5674
diff
changeset
|
65 struct _GaimGtkWindow |
4359 | 66 { |
67 GtkWidget *window; /**< The window. */ | |
68 GtkWidget *notebook; /**< The notebook of conversations. */ | |
69 | |
70 struct | |
71 { | |
10359 | 72 GtkWidget *menubox; |
4359 | 73 GtkWidget *menubar; |
74 | |
5167 | 75 GtkWidget *view_log; |
5908
ed8a9a3bf7e2
[gaim-migrate @ 6340]
Christian Hammond <chipx86@chipx86.com>
parents:
5872
diff
changeset
|
76 |
9468 | 77 GtkWidget *send_file; |
5908
ed8a9a3bf7e2
[gaim-migrate @ 6340]
Christian Hammond <chipx86@chipx86.com>
parents:
5872
diff
changeset
|
78 GtkWidget *add_pounce; |
7887 | 79 GtkWidget *get_info; |
80 GtkWidget *warn; | |
81 GtkWidget *invite; | |
82 | |
5908
ed8a9a3bf7e2
[gaim-migrate @ 6340]
Christian Hammond <chipx86@chipx86.com>
parents:
5872
diff
changeset
|
83 GtkWidget *alias; |
7887 | 84 GtkWidget *block; |
85 GtkWidget *add; | |
86 GtkWidget *remove; | |
5908
ed8a9a3bf7e2
[gaim-migrate @ 6340]
Christian Hammond <chipx86@chipx86.com>
parents:
5872
diff
changeset
|
87 |
7859 | 88 GtkWidget *insert_link; |
89 GtkWidget *insert_image; | |
90 | |
4359 | 91 GtkWidget *logging; |
92 GtkWidget *sounds; | |
7326
00a9ab26d607
[gaim-migrate @ 7912]
Christian Hammond <chipx86@chipx86.com>
parents:
7295
diff
changeset
|
93 GtkWidget *show_formatting_toolbar; |
9188 | 94 GtkWidget *show_timestamps; |
10456 | 95 GtkWidget *show_icon; |
5908
ed8a9a3bf7e2
[gaim-migrate @ 6340]
Christian Hammond <chipx86@chipx86.com>
parents:
5872
diff
changeset
|
96 |
4359 | 97 GtkWidget *send_as; |
5908
ed8a9a3bf7e2
[gaim-migrate @ 6340]
Christian Hammond <chipx86@chipx86.com>
parents:
5872
diff
changeset
|
98 |
4736 | 99 GtkWidget *typing_icon; |
4359 | 100 |
4630 | 101 GtkItemFactory *item_factory; |
102 | |
4359 | 103 } menu; |
104 | |
105 /* Tab dragging stuff. */ | |
106 gboolean in_drag; | |
107 gboolean in_predrag; | |
108 | |
109 gint drag_min_x, drag_max_x, drag_min_y, drag_max_y; | |
110 | |
111 gint drag_motion_signal; | |
112 gint drag_leave_signal; | |
113 }; | |
114 | |
115 /** | |
7820 | 116 * A GTK+ Instant Message pane. |
4359 | 117 */ |
5676
dae79aefac8d
[gaim-migrate @ 6094]
Christian Hammond <chipx86@chipx86.com>
parents:
5674
diff
changeset
|
118 struct _GaimGtkImPane |
4359 | 119 { |
120 GtkWidget *block; | |
9468 | 121 GtkWidget *send_file; |
4359 | 122 GtkWidget *sep1; |
123 GtkWidget *sep2; | |
124 GtkWidget *check; | |
125 GtkWidget *progress; | |
126 | |
127 gboolean a_virgin; | |
128 | |
129 /* Buddy icon stuff */ | |
9885 | 130 GtkWidget *icon_container; |
4359 | 131 GtkWidget *icon; |
9687 | 132 gboolean show_icon; |
8189 | 133 gboolean animate; |
4359 | 134 GdkPixbufAnimation *anim; |
135 GdkPixbufAnimationIter *iter; | |
136 guint32 icon_timer; | |
137 }; | |
138 | |
139 /** | |
140 * GTK+ Chat panes. | |
141 */ | |
5676
dae79aefac8d
[gaim-migrate @ 6094]
Christian Hammond <chipx86@chipx86.com>
parents:
5674
diff
changeset
|
142 struct _GaimGtkChatPane |
4359 | 143 { |
144 GtkWidget *count; | |
145 GtkWidget *list; | |
146 GtkWidget *topic_text; | |
10500 | 147 GtkWidget *userlist_im; |
148 GtkWidget *userlist_ignore; | |
149 GtkWidget *userlist_info; | |
4359 | 150 }; |
151 | |
152 /** | |
153 * A GTK+ conversation pane. | |
154 */ | |
5676
dae79aefac8d
[gaim-migrate @ 6094]
Christian Hammond <chipx86@chipx86.com>
parents:
5674
diff
changeset
|
155 struct _GaimGtkConversation |
4359 | 156 { |
157 gboolean make_sound; | |
7326
00a9ab26d607
[gaim-migrate @ 7912]
Christian Hammond <chipx86@chipx86.com>
parents:
7295
diff
changeset
|
158 gboolean show_formatting_toolbar; |
9188 | 159 gboolean show_timestamps; |
4359 | 160 |
161 GtkTooltips *tooltips; | |
162 | |
163 GtkWidget *tab_cont; | |
164 GtkWidget *tabby; | |
6771
8eebba08b44b
[gaim-migrate @ 7308]
Christian Hammond <chipx86@chipx86.com>
parents:
6392
diff
changeset
|
165 GtkWidget *menu_tabby; |
4359 | 166 |
167 GtkWidget *imhtml; | |
168 GtkTextBuffer *entry_buffer; | |
169 GtkWidget *entry; | |
170 | |
7930 | 171 GtkWidget *close; /* "x" on the tab */ |
6392
e9974608b319
[gaim-migrate @ 6897]
Christian Hammond <chipx86@chipx86.com>
parents:
5908
diff
changeset
|
172 GtkWidget *icon; |
4359 | 173 GtkWidget *tab_label; |
6771
8eebba08b44b
[gaim-migrate @ 7308]
Christian Hammond <chipx86@chipx86.com>
parents:
6392
diff
changeset
|
174 GtkWidget *menu_icon; |
8eebba08b44b
[gaim-migrate @ 7308]
Christian Hammond <chipx86@chipx86.com>
parents:
6392
diff
changeset
|
175 GtkWidget *menu_label; |
4359 | 176 GtkSizeGroup *sg; |
177 | |
9332 | 178 GtkWidget *lower_hbox; |
4359 | 179 |
8317 | 180 GtkWidget *toolbar; |
4359 | 181 |
182 struct | |
183 { | |
5106 | 184 GtkWidget *image; |
7295 | 185 GtkWidget *search; |
4359 | 186 |
187 } dialogs; | |
188 | |
189 union | |
190 { | |
5676
dae79aefac8d
[gaim-migrate @ 6094]
Christian Hammond <chipx86@chipx86.com>
parents:
5674
diff
changeset
|
191 GaimGtkImPane *im; |
dae79aefac8d
[gaim-migrate @ 6094]
Christian Hammond <chipx86@chipx86.com>
parents:
5674
diff
changeset
|
192 GaimGtkChatPane *chat; |
4359 | 193 |
194 } u; | |
195 }; | |
196 | |
5676
dae79aefac8d
[gaim-migrate @ 6094]
Christian Hammond <chipx86@chipx86.com>
parents:
5674
diff
changeset
|
197 /*@}*/ |
dae79aefac8d
[gaim-migrate @ 6094]
Christian Hammond <chipx86@chipx86.com>
parents:
5674
diff
changeset
|
198 |
4359 | 199 /************************************************************************** |
200 * @name GTK+ Conversation API | |
201 **************************************************************************/ | |
5673
62f57ec16f29
[gaim-migrate @ 6091]
Christian Hammond <chipx86@chipx86.com>
parents:
5167
diff
changeset
|
202 /*@{*/ |
62f57ec16f29
[gaim-migrate @ 6091]
Christian Hammond <chipx86@chipx86.com>
parents:
5167
diff
changeset
|
203 |
62f57ec16f29
[gaim-migrate @ 6091]
Christian Hammond <chipx86@chipx86.com>
parents:
5167
diff
changeset
|
204 /** |
4359 | 205 * Returns the UI operations structure for GTK windows. |
206 * | |
207 * @return The GTK window operations structure. | |
208 */ | |
7118
bf630f7dfdcd
[gaim-migrate @ 7685]
Christian Hammond <chipx86@chipx86.com>
parents:
7035
diff
changeset
|
209 GaimConvWindowUiOps *gaim_gtk_conversations_get_win_ui_ops(void); |
4359 | 210 |
211 /** | |
212 * Returns the UI operations structure for GTK conversations. | |
213 * | |
214 * @return The GTK conversation operations structure. | |
215 */ | |
7035
feb3d21a7794
[gaim-migrate @ 7598]
Christian Hammond <chipx86@chipx86.com>
parents:
6771
diff
changeset
|
216 GaimConversationUiOps *gaim_gtk_conversations_get_conv_ui_ops(void); |
4359 | 217 |
218 /** | |
219 * Updates the buddy icon on a conversation. | |
220 * | |
221 * @param conv The conversation. | |
222 */ | |
5676
dae79aefac8d
[gaim-migrate @ 6094]
Christian Hammond <chipx86@chipx86.com>
parents:
5674
diff
changeset
|
223 void gaim_gtkconv_update_buddy_icon(GaimConversation *conv); |
4359 | 224 |
225 /** | |
226 * Updates the tab positions on all conversation windows to reflect any | |
227 * changed preferences. | |
228 */ | |
229 void gaim_gtkconv_update_tabs(void); | |
230 | |
231 /** | |
232 * Updates conversation buttons by protocol. | |
233 * | |
234 * @param conv The conversation. | |
235 */ | |
5676
dae79aefac8d
[gaim-migrate @ 6094]
Christian Hammond <chipx86@chipx86.com>
parents:
5674
diff
changeset
|
236 void gaim_gtkconv_update_buttons_by_protocol(GaimConversation *conv); |
4359 | 237 |
238 /** | |
9759 | 239 * Creates a conversation button |
240 * | |
241 * @param icon The stock icon name. | |
242 * @param text The text for the button. | |
243 * @param tooltip The tooltip text. | |
244 * @param tooltips The group of tooltips. | |
245 * @param callback A function to call when the button is clicked. | |
246 * @param data Data to pass to the callback. | |
247 * | |
248 * @return The button | |
249 */ | |
250 GtkWidget *gaim_gtkconv_button_new(const char *icon, const char *text, | |
251 const char *tooltip, GtkTooltips *tooltips, | |
252 void *callback, void *data); | |
253 | |
254 /** | |
4359 | 255 * Returns the window at the specified X, Y location. |
256 * | |
257 * If the window is not a GTK+ window, @c NULL is returned. | |
258 * | |
259 * @param x The X coordinate. | |
260 * @param y The Y coordinate. | |
261 * | |
262 * @return The GTK+ window at the location, if it exists, or @c NULL otherwise. | |
263 */ | |
7118
bf630f7dfdcd
[gaim-migrate @ 7685]
Christian Hammond <chipx86@chipx86.com>
parents:
7035
diff
changeset
|
264 GaimConvWindow *gaim_gtkwin_get_at_xy(int x, int y); |
4359 | 265 |
266 /** | |
267 * Returns the index of the tab at the specified X, Y location in a notebook. | |
268 * | |
269 * @param win The GTK+ window containing the notebook. | |
270 * @param x The X coordinate. | |
271 * @param y The Y coordinate. | |
272 * | |
273 * @return The index of the tab at the location. | |
274 */ | |
7118
bf630f7dfdcd
[gaim-migrate @ 7685]
Christian Hammond <chipx86@chipx86.com>
parents:
7035
diff
changeset
|
275 int gaim_gtkconv_get_tab_at_xy(GaimConvWindow *win, int x, int y); |
4359 | 276 |
277 /** | |
278 * Returns the index of the destination tab at the | |
279 * specified X, Y location in a notebook. | |
280 * | |
281 * This is used for drag-and-drop functions when the tab at the index | |
282 * is a destination tab. | |
283 * | |
284 * @param win The GTK+ window containing the notebook. | |
285 * @param x The X coordinate. | |
286 * @param y The Y coordinate. | |
287 * | |
288 * @return The index of the tab at the location. | |
289 */ | |
7118
bf630f7dfdcd
[gaim-migrate @ 7685]
Christian Hammond <chipx86@chipx86.com>
parents:
7035
diff
changeset
|
290 int gaim_gtkconv_get_dest_tab_at_xy(GaimConvWindow *win, int x, int y); |
4359 | 291 |
5673
62f57ec16f29
[gaim-migrate @ 6091]
Christian Hammond <chipx86@chipx86.com>
parents:
5167
diff
changeset
|
292 /*@}*/ |
62f57ec16f29
[gaim-migrate @ 6091]
Christian Hammond <chipx86@chipx86.com>
parents:
5167
diff
changeset
|
293 |
8582
d7c85220c685
[gaim-migrate @ 9332]
Christian Hammond <chipx86@chipx86.com>
parents:
8317
diff
changeset
|
294 /**************************************************************************/ |
d7c85220c685
[gaim-migrate @ 9332]
Christian Hammond <chipx86@chipx86.com>
parents:
8317
diff
changeset
|
295 /** @name GTK+ Conversations Subsystem */ |
d7c85220c685
[gaim-migrate @ 9332]
Christian Hammond <chipx86@chipx86.com>
parents:
8317
diff
changeset
|
296 /**************************************************************************/ |
d7c85220c685
[gaim-migrate @ 9332]
Christian Hammond <chipx86@chipx86.com>
parents:
8317
diff
changeset
|
297 /*@{*/ |
d7c85220c685
[gaim-migrate @ 9332]
Christian Hammond <chipx86@chipx86.com>
parents:
8317
diff
changeset
|
298 |
d7c85220c685
[gaim-migrate @ 9332]
Christian Hammond <chipx86@chipx86.com>
parents:
8317
diff
changeset
|
299 /** |
d7c85220c685
[gaim-migrate @ 9332]
Christian Hammond <chipx86@chipx86.com>
parents:
8317
diff
changeset
|
300 * Returns the gtk conversations subsystem handle. |
d7c85220c685
[gaim-migrate @ 9332]
Christian Hammond <chipx86@chipx86.com>
parents:
8317
diff
changeset
|
301 * |
d7c85220c685
[gaim-migrate @ 9332]
Christian Hammond <chipx86@chipx86.com>
parents:
8317
diff
changeset
|
302 * @return The conversations subsystem handle. |
d7c85220c685
[gaim-migrate @ 9332]
Christian Hammond <chipx86@chipx86.com>
parents:
8317
diff
changeset
|
303 */ |
d7c85220c685
[gaim-migrate @ 9332]
Christian Hammond <chipx86@chipx86.com>
parents:
8317
diff
changeset
|
304 void *gaim_gtk_conversations_get_handle(void); |
d7c85220c685
[gaim-migrate @ 9332]
Christian Hammond <chipx86@chipx86.com>
parents:
8317
diff
changeset
|
305 |
d7c85220c685
[gaim-migrate @ 9332]
Christian Hammond <chipx86@chipx86.com>
parents:
8317
diff
changeset
|
306 /** |
d7c85220c685
[gaim-migrate @ 9332]
Christian Hammond <chipx86@chipx86.com>
parents:
8317
diff
changeset
|
307 * Initializes the GTK+ conversations subsystem. |
d7c85220c685
[gaim-migrate @ 9332]
Christian Hammond <chipx86@chipx86.com>
parents:
8317
diff
changeset
|
308 */ |
d7c85220c685
[gaim-migrate @ 9332]
Christian Hammond <chipx86@chipx86.com>
parents:
8317
diff
changeset
|
309 void gaim_gtk_conversations_init(void); |
d7c85220c685
[gaim-migrate @ 9332]
Christian Hammond <chipx86@chipx86.com>
parents:
8317
diff
changeset
|
310 |
d7c85220c685
[gaim-migrate @ 9332]
Christian Hammond <chipx86@chipx86.com>
parents:
8317
diff
changeset
|
311 /** |
d7c85220c685
[gaim-migrate @ 9332]
Christian Hammond <chipx86@chipx86.com>
parents:
8317
diff
changeset
|
312 * Uninitialized the GTK+ conversation subsystem. |
d7c85220c685
[gaim-migrate @ 9332]
Christian Hammond <chipx86@chipx86.com>
parents:
8317
diff
changeset
|
313 */ |
d7c85220c685
[gaim-migrate @ 9332]
Christian Hammond <chipx86@chipx86.com>
parents:
8317
diff
changeset
|
314 void gaim_gtk_conversations_uninit(void); |
d7c85220c685
[gaim-migrate @ 9332]
Christian Hammond <chipx86@chipx86.com>
parents:
8317
diff
changeset
|
315 |
d7c85220c685
[gaim-migrate @ 9332]
Christian Hammond <chipx86@chipx86.com>
parents:
8317
diff
changeset
|
316 /*@}*/ |
d7c85220c685
[gaim-migrate @ 9332]
Christian Hammond <chipx86@chipx86.com>
parents:
8317
diff
changeset
|
317 |
9713 | 318 #endif /* _GAIM_GTKCONVERSATION_H_ */ |