Mercurial > pidgin
annotate src/notify.h @ 13199:d8f238864c88
[gaim-migrate @ 15562]
Is there any reason we use gtk_widget_show() everywhere instead of
gtk_widget_show_all()
committer: Tailor Script <tailor@pidgin.im>
author | Mark Doliner <mark@kingant.net> |
---|---|
date | Thu, 09 Feb 2006 04:14:54 +0000 |
parents | 852df2d9d4f8 |
children | d12bbe6da705 |
rev | line source |
---|---|
5437 | 1 /** |
2 * @file notify.h Notification API | |
3 * @ingroup core | |
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. | |
6465
fb64cc87bc96
[gaim-migrate @ 6974]
Christian Hammond <chipx86@chipx86.com>
parents:
6381
diff
changeset
|
10 * |
5437 | 11 * This program is free software; you can redistribute it and/or modify |
12 * it under the terms of the GNU General Public License as published by | |
13 * the Free Software Foundation; either version 2 of the License, or | |
14 * (at your option) any later version. | |
15 * | |
16 * This program is distributed in the hope that it will be useful, | |
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
19 * GNU General Public License for more details. | |
20 * | |
21 * You should have received a copy of the GNU General Public License | |
22 * along with this program; if not, write to the Free Software | |
23 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA | |
24 */ | |
25 #ifndef _GAIM_NOTIFY_H_ | |
26 #define _GAIM_NOTIFY_H_ | |
27 | |
28 #include <stdlib.h> | |
29 #include <glib-object.h> | |
30 #include <glib.h> | |
31 | |
9797 | 32 #include "connection.h" |
33 | |
12624
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
34 |
5437 | 35 /** |
12242
976677e67239
[gaim-migrate @ 14544]
Richard Laager <rlaager@wiktel.com>
parents:
12220
diff
changeset
|
36 * Notification close callbacks. |
976677e67239
[gaim-migrate @ 14544]
Richard Laager <rlaager@wiktel.com>
parents:
12220
diff
changeset
|
37 */ |
976677e67239
[gaim-migrate @ 14544]
Richard Laager <rlaager@wiktel.com>
parents:
12220
diff
changeset
|
38 typedef void (*GaimNotifyCloseCallback) (gpointer user_data); |
976677e67239
[gaim-migrate @ 14544]
Richard Laager <rlaager@wiktel.com>
parents:
12220
diff
changeset
|
39 |
12624
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
40 |
12242
976677e67239
[gaim-migrate @ 14544]
Richard Laager <rlaager@wiktel.com>
parents:
12220
diff
changeset
|
41 /** |
5437 | 42 * Notification types. |
43 */ | |
44 typedef enum | |
45 { | |
10439 | 46 GAIM_NOTIFY_MESSAGE = 0, /**< Message notification. */ |
47 GAIM_NOTIFY_EMAIL, /**< Single e-mail notification. */ | |
48 GAIM_NOTIFY_EMAILS, /**< Multiple e-mail notification. */ | |
49 GAIM_NOTIFY_FORMATTED, /**< Formatted text. */ | |
50 GAIM_NOTIFY_SEARCHRESULTS, /**< Buddy search results. */ | |
51 GAIM_NOTIFY_USERINFO, /**< Formatted userinfo text. */ | |
52 GAIM_NOTIFY_URI /**< URI notification or display. */ | |
5437 | 53 |
54 } GaimNotifyType; | |
55 | |
12624
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
56 |
5437 | 57 /** |
58 * Notification message types. | |
59 */ | |
60 typedef enum | |
61 { | |
62 GAIM_NOTIFY_MSG_ERROR = 0, /**< Error notification. */ | |
63 GAIM_NOTIFY_MSG_WARNING, /**< Warning notification. */ | |
64 GAIM_NOTIFY_MSG_INFO /**< Information notification. */ | |
65 | |
66 } GaimNotifyMsgType; | |
67 | |
12624
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
68 |
5437 | 69 /** |
11359 | 70 * The types of buttons |
71 */ | |
72 typedef enum | |
73 { | |
12624
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
74 GAIM_NOTIFY_BUTTON_LABELED = 0, /**< special use, see _button_add_labeled */ |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
75 GAIM_NOTIFY_BUTTON_CONTINUE = 1, |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
76 GAIM_NOTIFY_BUTTON_ADD, |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
77 GAIM_NOTIFY_BUTTON_INFO, |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
78 GAIM_NOTIFY_BUTTON_IM, |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
79 GAIM_NOTIFY_BUTTON_JOIN, |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
80 GAIM_NOTIFY_BUTTON_INVITE |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
81 } GaimNotifySearchButtonType; |
11359 | 82 |
83 | |
84 /** | |
85 * Search results object. | |
86 */ | |
87 typedef struct | |
88 { | |
89 GList *columns; /**< List of the search column objects. */ | |
90 GList *rows; /**< List of rows in the result. */ | |
91 GList *buttons; /**< List of buttons to display. */ | |
92 | |
93 } GaimNotifySearchResults; | |
94 | |
12624
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
95 |
11359 | 96 /** |
97 * Single column of a search result. | |
98 */ | |
99 typedef struct | |
100 { | |
101 char *title; /**< Title of the column. */ | |
102 | |
103 } GaimNotifySearchColumn; | |
104 | |
12624
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
105 |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
106 /** |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
107 * Callback for a button in a search result. |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
108 * |
12625
ba47bcf7c6eb
[gaim-migrate @ 14961]
Christopher O'Brien <siege@pidgin.im>
parents:
12624
diff
changeset
|
109 * @param c the GaimConnection passed to gaim_notify_searchresults |
ba47bcf7c6eb
[gaim-migrate @ 14961]
Christopher O'Brien <siege@pidgin.im>
parents:
12624
diff
changeset
|
110 * @param row the contents of the selected row |
12624
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
111 */ |
12625
ba47bcf7c6eb
[gaim-migrate @ 14961]
Christopher O'Brien <siege@pidgin.im>
parents:
12624
diff
changeset
|
112 typedef void (*GaimNotifySearchResultsCallback)(GaimConnection *c, GList *row); |
11359 | 113 |
114 | |
115 /** | |
116 * Definition of a button. | |
117 */ | |
118 typedef struct | |
119 { | |
120 GaimNotifySearchButtonType type; | |
121 GaimNotifySearchResultsCallback callback; /**< Function to be called when clicked. */ | |
12624
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
122 char *label; /**< only for GAIM_NOTIFY_BUTTON_LABELED */ |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
123 } GaimNotifySearchButton; |
11359 | 124 |
125 | |
126 /** | |
5437 | 127 * Notification UI operations. |
128 */ | |
129 typedef struct | |
130 { | |
131 void *(*notify_message)(GaimNotifyMsgType type, const char *title, | |
12624
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
132 const char *primary, const char *secondary); |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
133 |
12647
852df2d9d4f8
[gaim-migrate @ 14985]
Richard Laager <rlaager@wiktel.com>
parents:
12625
diff
changeset
|
134 void *(*notify_email)(GaimConnection *gc, |
852df2d9d4f8
[gaim-migrate @ 14985]
Richard Laager <rlaager@wiktel.com>
parents:
12625
diff
changeset
|
135 const char *subject, const char *from, |
12624
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
136 const char *to, const char *url); |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
137 |
12647
852df2d9d4f8
[gaim-migrate @ 14985]
Richard Laager <rlaager@wiktel.com>
parents:
12625
diff
changeset
|
138 void *(*notify_emails)(GaimConnection *gc, |
852df2d9d4f8
[gaim-migrate @ 14985]
Richard Laager <rlaager@wiktel.com>
parents:
12625
diff
changeset
|
139 size_t count, gboolean detailed, |
12624
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
140 const char **subjects, const char **froms, |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
141 const char **tos, const char **urls); |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
142 |
6381
e006685f75aa
[gaim-migrate @ 6886]
Christian Hammond <chipx86@chipx86.com>
parents:
6356
diff
changeset
|
143 void *(*notify_formatted)(const char *title, const char *primary, |
12624
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
144 const char *secondary, const char *text); |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
145 |
10439 | 146 void *(*notify_searchresults)(GaimConnection *gc, const char *title, |
12624
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
147 const char *primary, const char *secondary, |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
148 GaimNotifySearchResults *results); |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
149 |
11359 | 150 void (*notify_searchresults_new_rows)(GaimConnection *gc, |
12624
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
151 GaimNotifySearchResults *results, |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
152 void *data, gpointer user_data); |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
153 |
9797 | 154 void *(*notify_userinfo)(GaimConnection *gc, const char *who, |
12624
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
155 const char *text); |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
156 |
10240
95ca0db2d01d
[gaim-migrate @ 11377]
Herman Bloggs <hermanator12002@yahoo.com>
parents:
10209
diff
changeset
|
157 void *(*notify_uri)(const char *uri); |
5437 | 158 |
5476
9bcd8cd625ae
[gaim-migrate @ 5872]
Christian Hammond <chipx86@chipx86.com>
parents:
5437
diff
changeset
|
159 void (*close_notify)(GaimNotifyType type, void *ui_handle); |
5437 | 160 |
161 } GaimNotifyUiOps; | |
162 | |
12624
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
163 |
5944
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5522
diff
changeset
|
164 #ifdef __cplusplus |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5522
diff
changeset
|
165 extern "C" { |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5522
diff
changeset
|
166 #endif |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5522
diff
changeset
|
167 |
12624
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
168 |
5437 | 169 /**************************************************************************/ |
11359 | 170 /** Search results notification API */ |
171 /**************************************************************************/ | |
172 /*@{*/ | |
173 | |
174 /** | |
175 * Displays results from a buddy search. This can be, for example, | |
176 * a window with a list of all found buddies, where you are given the | |
177 * option of adding buddies to your buddy list. | |
178 * | |
179 * @param gc The GaimConnection handle associated with the information. | |
180 * @param title The title of the message. If this is NULL, the title | |
12259
0c82fd31628b
[gaim-migrate @ 14561]
Richard Laager <rlaager@wiktel.com>
parents:
12257
diff
changeset
|
181 * will be "Search Results." |
11359 | 182 * @param primary The main point of the message. |
183 * @param secondary The secondary information. | |
184 * @param results The GaimNotifySearchResults instance. | |
185 * @param cb The callback to call when the user closes | |
186 * the notification. | |
187 * @param user_data The data to pass to the callback. | |
188 * | |
189 * @return A UI-specific handle. | |
190 */ | |
191 void *gaim_notify_searchresults(GaimConnection *gc, const char *title, | |
192 const char *primary, const char *secondary, | |
12242
976677e67239
[gaim-migrate @ 14544]
Richard Laager <rlaager@wiktel.com>
parents:
12220
diff
changeset
|
193 GaimNotifySearchResults *results, GaimNotifyCloseCallback cb, |
12220
64254fbabc7b
[gaim-migrate @ 14522]
Richard Laager <rlaager@wiktel.com>
parents:
12129
diff
changeset
|
194 gpointer user_data); |
11359 | 195 |
196 void gaim_notify_searchresults_free(GaimNotifySearchResults *results); | |
197 | |
198 /** | |
199 * Replace old rows with the new. Reuse an existing window. | |
200 * | |
201 * @param gc The GaimConnection structure. | |
202 * @param results The GaimNotifySearchResults structure. | |
203 * @param data Data returned by the gaim_notify_searchresults(). | |
204 * @param user_data User defined data. | |
205 */ | |
206 void gaim_notify_searchresults_new_rows(GaimConnection *gc, | |
207 GaimNotifySearchResults *results, | |
12220
64254fbabc7b
[gaim-migrate @ 14522]
Richard Laager <rlaager@wiktel.com>
parents:
12129
diff
changeset
|
208 void *data, gpointer user_data); |
11359 | 209 |
12624
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
210 |
11359 | 211 /** |
12624
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
212 * Adds a stock button that will be displayed in the search results dialog. |
11359 | 213 * |
214 * @param results The search results object. | |
215 * @param type Type of the button. (TODO: Only one button of a given type can be displayed.) | |
216 * @param cb Function that will be called on the click event. | |
217 */ | |
218 void gaim_notify_searchresults_button_add(GaimNotifySearchResults *results, | |
219 GaimNotifySearchButtonType type, | |
220 GaimNotifySearchResultsCallback cb); | |
221 | |
12624
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
222 |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
223 /** |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
224 * Adds a plain labelled button that will be displayed in the search results dialog. |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
225 * |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
226 * @param results The search results object |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
227 * @param label The label to display |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
228 * @param cb Function that will be called on the click event |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
229 */ |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
230 void gaim_notify_searchresults_button_add_labeled(GaimNotifySearchResults *results, |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
231 const char *label, |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
232 GaimNotifySearchResultsCallback cb); |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
233 |
851b0bd7eb52
[gaim-migrate @ 14960]
Christopher O'Brien <siege@pidgin.im>
parents:
12323
diff
changeset
|
234 |
11359 | 235 /** |
236 * Returns a newly created search results object. | |
237 * | |
238 * @return The new search results object. | |
239 */ | |
12323
fc464a0abccc
[gaim-migrate @ 14627]
Richard Laager <rlaager@wiktel.com>
parents:
12259
diff
changeset
|
240 GaimNotifySearchResults *gaim_notify_searchresults_new(void); |
11359 | 241 |
242 /** | |
243 * Returns a newly created search result column object. | |
244 * | |
245 * @param title Title of the column. NOTE: Title will get g_strdup()ed. | |
246 * | |
247 * @return The new search column object. | |
248 */ | |
249 GaimNotifySearchColumn *gaim_notify_searchresults_column_new(const char *title); | |
250 | |
251 /** | |
252 * Adds a new column to the search result object. | |
253 * | |
254 * @param results The result object to which the column will be added. | |
11501
9563b768e8e2
[gaim-migrate @ 13746]
Richard Laager <rlaager@wiktel.com>
parents:
11359
diff
changeset
|
255 * @param column The column that will be added to the result object. |
11359 | 256 */ |
257 void gaim_notify_searchresults_column_add(GaimNotifySearchResults *results, | |
258 GaimNotifySearchColumn *column); | |
259 | |
260 /** | |
261 * Adds a new row of the results to the search results object. | |
262 * | |
263 * @param results The search results object. | |
264 * @param row The row of the results. | |
265 */ | |
266 void gaim_notify_searchresults_row_add(GaimNotifySearchResults *results, | |
267 GList *row); | |
268 | |
269 /** | |
270 * Returns a number of the rows in the search results object. | |
271 * | |
272 * @param results The search results object. | |
273 * | |
12257
ca27de274225
[gaim-migrate @ 14559]
Richard Laager <rlaager@wiktel.com>
parents:
12242
diff
changeset
|
274 * @return Number of the result rows. |
11359 | 275 */ |
12257
ca27de274225
[gaim-migrate @ 14559]
Richard Laager <rlaager@wiktel.com>
parents:
12242
diff
changeset
|
276 guint gaim_notify_searchresults_get_rows_count(GaimNotifySearchResults *results); |
11359 | 277 |
278 /** | |
279 * Returns a number of the columns in the search results object. | |
280 * | |
281 * @param results The search results object. | |
282 * | |
12257
ca27de274225
[gaim-migrate @ 14559]
Richard Laager <rlaager@wiktel.com>
parents:
12242
diff
changeset
|
283 * @return Number of the columns. |
11359 | 284 */ |
12257
ca27de274225
[gaim-migrate @ 14559]
Richard Laager <rlaager@wiktel.com>
parents:
12242
diff
changeset
|
285 guint gaim_notify_searchresults_get_columns_count(GaimNotifySearchResults *results); |
11359 | 286 |
287 /** | |
288 * Returns a row of the results from the search results object. | |
289 * | |
290 * @param results The search results object. | |
291 * @param row_id Index of the row to be returned. | |
292 * | |
293 * @return Row of the results. | |
294 */ | |
295 GList *gaim_notify_searchresults_row_get(GaimNotifySearchResults *results, | |
296 unsigned int row_id); | |
297 | |
298 /** | |
299 * Returns a title of the search results object's column. | |
300 * | |
301 * @param results The search results object. | |
302 * @param column_id Index of the column. | |
303 * | |
304 * @return Title of the column. | |
305 */ | |
306 char *gaim_notify_searchresults_column_get_title(GaimNotifySearchResults *results, | |
307 unsigned int column_id); | |
308 | |
309 /*@}*/ | |
310 | |
311 /**************************************************************************/ | |
5437 | 312 /** @name Notification API */ |
313 /**************************************************************************/ | |
314 /*@{*/ | |
315 | |
316 /** | |
317 * Displays a notification message to the user. | |
318 * | |
319 * @param handle The plugin or connection handle. | |
320 * @param type The notification type. | |
321 * @param title The title of the message. | |
322 * @param primary The main point of the message. | |
323 * @param secondary The secondary information. | |
324 * @param cb The callback to call when the user closes | |
325 * the notification. | |
326 * @param user_data The data to pass to the callback. | |
327 * | |
328 * @return A UI-specific handle. | |
329 */ | |
6356
ee0044f3e377
[gaim-migrate @ 6855]
Christian Hammond <chipx86@chipx86.com>
parents:
5944
diff
changeset
|
330 void *gaim_notify_message(void *handle, GaimNotifyMsgType type, |
5437 | 331 const char *title, const char *primary, |
12242
976677e67239
[gaim-migrate @ 14544]
Richard Laager <rlaager@wiktel.com>
parents:
12220
diff
changeset
|
332 const char *secondary, GaimNotifyCloseCallback cb, |
12220
64254fbabc7b
[gaim-migrate @ 14522]
Richard Laager <rlaager@wiktel.com>
parents:
12129
diff
changeset
|
333 gpointer user_data); |
5437 | 334 |
335 /** | |
336 * Displays a single e-mail notification to the user. | |
337 * | |
338 * @param handle The plugin or connection handle. | |
339 * @param subject The subject of the e-mail. | |
340 * @param from The from address. | |
341 * @param to The destination address. | |
342 * @param url The URL where the message can be read. | |
343 * @param cb The callback to call when the user closes | |
344 * the notification. | |
345 * @param user_data The data to pass to the callback. | |
346 * | |
347 * @return A UI-specific handle. | |
348 */ | |
349 void *gaim_notify_email(void *handle, const char *subject, | |
350 const char *from, const char *to, | |
12242
976677e67239
[gaim-migrate @ 14544]
Richard Laager <rlaager@wiktel.com>
parents:
12220
diff
changeset
|
351 const char *url, GaimNotifyCloseCallback cb, |
12220
64254fbabc7b
[gaim-migrate @ 14522]
Richard Laager <rlaager@wiktel.com>
parents:
12129
diff
changeset
|
352 gpointer user_data); |
5437 | 353 |
354 /** | |
355 * Displays a notification for multiple e-mails to the user. | |
356 * | |
357 * @param handle The plugin or connection handle. | |
358 * @param count The number of e-mails. | |
5522
a3e6a5ef49b5
[gaim-migrate @ 5922]
Christian Hammond <chipx86@chipx86.com>
parents:
5497
diff
changeset
|
359 * @param detailed @c TRUE if there is information for each e-mail in the |
a3e6a5ef49b5
[gaim-migrate @ 5922]
Christian Hammond <chipx86@chipx86.com>
parents:
5497
diff
changeset
|
360 * arrays. |
5437 | 361 * @param subjects The array of subjects. |
362 * @param froms The array of from addresses. | |
363 * @param tos The array of destination addresses. | |
6720
41120df7ed94
[gaim-migrate @ 7247]
Christian Hammond <chipx86@chipx86.com>
parents:
6467
diff
changeset
|
364 * @param urls The URLs where the messages can be read. |
5437 | 365 * @param cb The callback to call when the user closes |
366 * the notification. | |
367 * @param user_data The data to pass to the callback. | |
368 * | |
369 * @return A UI-specific handle. | |
370 */ | |
5522
a3e6a5ef49b5
[gaim-migrate @ 5922]
Christian Hammond <chipx86@chipx86.com>
parents:
5497
diff
changeset
|
371 void *gaim_notify_emails(void *handle, size_t count, gboolean detailed, |
5437 | 372 const char **subjects, const char **froms, |
373 const char **tos, const char **urls, | |
12242
976677e67239
[gaim-migrate @ 14544]
Richard Laager <rlaager@wiktel.com>
parents:
12220
diff
changeset
|
374 GaimNotifyCloseCallback cb, gpointer user_data); |
5437 | 375 |
376 /** | |
6381
e006685f75aa
[gaim-migrate @ 6886]
Christian Hammond <chipx86@chipx86.com>
parents:
6356
diff
changeset
|
377 * Displays a notification with formatted text. |
e006685f75aa
[gaim-migrate @ 6886]
Christian Hammond <chipx86@chipx86.com>
parents:
6356
diff
changeset
|
378 * |
e006685f75aa
[gaim-migrate @ 6886]
Christian Hammond <chipx86@chipx86.com>
parents:
6356
diff
changeset
|
379 * The text is essentially a stripped-down format of HTML, the same that |
e006685f75aa
[gaim-migrate @ 6886]
Christian Hammond <chipx86@chipx86.com>
parents:
6356
diff
changeset
|
380 * IMs may send. |
e006685f75aa
[gaim-migrate @ 6886]
Christian Hammond <chipx86@chipx86.com>
parents:
6356
diff
changeset
|
381 * |
e006685f75aa
[gaim-migrate @ 6886]
Christian Hammond <chipx86@chipx86.com>
parents:
6356
diff
changeset
|
382 * @param handle The plugin or connection handle. |
e006685f75aa
[gaim-migrate @ 6886]
Christian Hammond <chipx86@chipx86.com>
parents:
6356
diff
changeset
|
383 * @param title The title of the message. |
e006685f75aa
[gaim-migrate @ 6886]
Christian Hammond <chipx86@chipx86.com>
parents:
6356
diff
changeset
|
384 * @param primary The main point of the message. |
e006685f75aa
[gaim-migrate @ 6886]
Christian Hammond <chipx86@chipx86.com>
parents:
6356
diff
changeset
|
385 * @param secondary The secondary information. |
e006685f75aa
[gaim-migrate @ 6886]
Christian Hammond <chipx86@chipx86.com>
parents:
6356
diff
changeset
|
386 * @param text The formatted text. |
e006685f75aa
[gaim-migrate @ 6886]
Christian Hammond <chipx86@chipx86.com>
parents:
6356
diff
changeset
|
387 * @param cb The callback to call when the user closes |
e006685f75aa
[gaim-migrate @ 6886]
Christian Hammond <chipx86@chipx86.com>
parents:
6356
diff
changeset
|
388 * the notification. |
6720
41120df7ed94
[gaim-migrate @ 7247]
Christian Hammond <chipx86@chipx86.com>
parents:
6467
diff
changeset
|
389 * @param user_data The data to pass to the callback. |
6381
e006685f75aa
[gaim-migrate @ 6886]
Christian Hammond <chipx86@chipx86.com>
parents:
6356
diff
changeset
|
390 * |
e006685f75aa
[gaim-migrate @ 6886]
Christian Hammond <chipx86@chipx86.com>
parents:
6356
diff
changeset
|
391 * @return A UI-specific handle. |
e006685f75aa
[gaim-migrate @ 6886]
Christian Hammond <chipx86@chipx86.com>
parents:
6356
diff
changeset
|
392 */ |
e006685f75aa
[gaim-migrate @ 6886]
Christian Hammond <chipx86@chipx86.com>
parents:
6356
diff
changeset
|
393 void *gaim_notify_formatted(void *handle, const char *title, |
e006685f75aa
[gaim-migrate @ 6886]
Christian Hammond <chipx86@chipx86.com>
parents:
6356
diff
changeset
|
394 const char *primary, const char *secondary, |
12242
976677e67239
[gaim-migrate @ 14544]
Richard Laager <rlaager@wiktel.com>
parents:
12220
diff
changeset
|
395 const char *text, GaimNotifyCloseCallback cb, gpointer user_data); |
6381
e006685f75aa
[gaim-migrate @ 6886]
Christian Hammond <chipx86@chipx86.com>
parents:
6356
diff
changeset
|
396 |
e006685f75aa
[gaim-migrate @ 6886]
Christian Hammond <chipx86@chipx86.com>
parents:
6356
diff
changeset
|
397 /** |
9800 | 398 * Displays user information with formatted text, passing information giving |
399 * the connection and username from which the user information came. | |
9797 | 400 * |
401 * The text is essentially a stripped-down format of HTML, the same that | |
402 * IMs may send. | |
403 * | |
11533
c9b815aeddc1
[gaim-migrate @ 13782]
Richard Laager <rlaager@wiktel.com>
parents:
11531
diff
changeset
|
404 * @param gc The GaimConnection handle associated with the information. |
c9b815aeddc1
[gaim-migrate @ 13782]
Richard Laager <rlaager@wiktel.com>
parents:
11531
diff
changeset
|
405 * @param who The username associated with the information. |
9797 | 406 * @param text The formatted text. |
407 * @param cb The callback to call when the user closes | |
408 * the notification. | |
409 * @param user_data The data to pass to the callback. | |
410 * | |
411 * @return A UI-specific handle. | |
412 */ | |
413 void *gaim_notify_userinfo(GaimConnection *gc, const char *who, | |
12242
976677e67239
[gaim-migrate @ 14544]
Richard Laager <rlaager@wiktel.com>
parents:
12220
diff
changeset
|
414 const char *text, GaimNotifyCloseCallback cb, |
12220
64254fbabc7b
[gaim-migrate @ 14522]
Richard Laager <rlaager@wiktel.com>
parents:
12129
diff
changeset
|
415 gpointer user_data); |
9797 | 416 |
417 /** | |
6465
fb64cc87bc96
[gaim-migrate @ 6974]
Christian Hammond <chipx86@chipx86.com>
parents:
6381
diff
changeset
|
418 * Opens a URI or somehow presents it to the user. |
fb64cc87bc96
[gaim-migrate @ 6974]
Christian Hammond <chipx86@chipx86.com>
parents:
6381
diff
changeset
|
419 * |
10240
95ca0db2d01d
[gaim-migrate @ 11377]
Herman Bloggs <hermanator12002@yahoo.com>
parents:
10209
diff
changeset
|
420 * @param handle The plugin or connection handle. |
95ca0db2d01d
[gaim-migrate @ 11377]
Herman Bloggs <hermanator12002@yahoo.com>
parents:
10209
diff
changeset
|
421 * @param uri The URI to display or go to. |
6465
fb64cc87bc96
[gaim-migrate @ 6974]
Christian Hammond <chipx86@chipx86.com>
parents:
6381
diff
changeset
|
422 * |
fb64cc87bc96
[gaim-migrate @ 6974]
Christian Hammond <chipx86@chipx86.com>
parents:
6381
diff
changeset
|
423 * @return A UI-specific handle, if any. This may only be presented if |
fb64cc87bc96
[gaim-migrate @ 6974]
Christian Hammond <chipx86@chipx86.com>
parents:
6381
diff
changeset
|
424 * the UI code displays a dialog instead of a webpage, or something |
fb64cc87bc96
[gaim-migrate @ 6974]
Christian Hammond <chipx86@chipx86.com>
parents:
6381
diff
changeset
|
425 * similar. |
fb64cc87bc96
[gaim-migrate @ 6974]
Christian Hammond <chipx86@chipx86.com>
parents:
6381
diff
changeset
|
426 */ |
10240
95ca0db2d01d
[gaim-migrate @ 11377]
Herman Bloggs <hermanator12002@yahoo.com>
parents:
10209
diff
changeset
|
427 void *gaim_notify_uri(void *handle, const char *uri); |
6465
fb64cc87bc96
[gaim-migrate @ 6974]
Christian Hammond <chipx86@chipx86.com>
parents:
6381
diff
changeset
|
428 |
fb64cc87bc96
[gaim-migrate @ 6974]
Christian Hammond <chipx86@chipx86.com>
parents:
6381
diff
changeset
|
429 /** |
5437 | 430 * Closes a notification. |
431 * | |
432 * This should be used only by the UI operation functions and part of the | |
433 * core. | |
434 * | |
5476
9bcd8cd625ae
[gaim-migrate @ 5872]
Christian Hammond <chipx86@chipx86.com>
parents:
5437
diff
changeset
|
435 * @param type The notification type. |
9bcd8cd625ae
[gaim-migrate @ 5872]
Christian Hammond <chipx86@chipx86.com>
parents:
5437
diff
changeset
|
436 * @param ui_handle The notification UI handle. |
5437 | 437 */ |
5476
9bcd8cd625ae
[gaim-migrate @ 5872]
Christian Hammond <chipx86@chipx86.com>
parents:
5437
diff
changeset
|
438 void gaim_notify_close(GaimNotifyType type, void *ui_handle); |
5437 | 439 |
440 /** | |
441 * Closes all notifications registered with the specified handle. | |
442 * | |
443 * @param handle The handle. | |
444 */ | |
445 void gaim_notify_close_with_handle(void *handle); | |
446 | |
447 /** | |
448 * A wrapper for gaim_notify_message that displays an information message. | |
449 */ | |
450 #define gaim_notify_info(handle, title, primary, secondary) \ | |
451 gaim_notify_message((handle), GAIM_NOTIFY_MSG_INFO, (title), \ | |
452 (primary), (secondary), NULL, NULL) | |
453 | |
454 /** | |
455 * A wrapper for gaim_notify_message that displays a warning message. | |
456 */ | |
457 #define gaim_notify_warning(handle, title, primary, secondary) \ | |
458 gaim_notify_message((handle), GAIM_NOTIFY_MSG_WARNING, (title), \ | |
459 (primary), (secondary), NULL, NULL) | |
460 | |
461 /** | |
462 * A wrapper for gaim_notify_message that displays an error message. | |
463 */ | |
464 #define gaim_notify_error(handle, title, primary, secondary) \ | |
465 gaim_notify_message((handle), GAIM_NOTIFY_MSG_ERROR, (title), \ | |
466 (primary), (secondary), NULL, NULL) | |
467 | |
468 /*@}*/ | |
469 | |
470 /**************************************************************************/ | |
10566
62fc579810f4
[gaim-migrate @ 11949]
Etan Reisner <pidgin@unreliablesource.net>
parents:
10443
diff
changeset
|
471 /** @name UI Registration Functions */ |
5437 | 472 /**************************************************************************/ |
473 /*@{*/ | |
474 | |
475 /** | |
476 * Sets the UI operations structure to be used when displaying a | |
477 * notification. | |
478 * | |
479 * @param ops The UI operations structure. | |
480 */ | |
7035
feb3d21a7794
[gaim-migrate @ 7598]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
481 void gaim_notify_set_ui_ops(GaimNotifyUiOps *ops); |
5437 | 482 |
483 /** | |
484 * Returns the UI operations structure to be used when displaying a | |
485 * notification. | |
486 * | |
6467
aabb0b331ac8
[gaim-migrate @ 6976]
Christian Hammond <chipx86@chipx86.com>
parents:
6465
diff
changeset
|
487 * @return The UI operations structure. |
5437 | 488 */ |
7035
feb3d21a7794
[gaim-migrate @ 7598]
Christian Hammond <chipx86@chipx86.com>
parents:
6720
diff
changeset
|
489 GaimNotifyUiOps *gaim_notify_get_ui_ops(void); |
5944
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5522
diff
changeset
|
490 |
5497 | 491 /*@}*/ |
5437 | 492 |
12129
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
493 /**************************************************************************/ |
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
494 /** @name Notify Subsystem */ |
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
495 /**************************************************************************/ |
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
496 /*@{*/ |
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
497 |
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
498 /** |
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
499 * Returns the notify subsystem handle. |
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
500 * |
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
501 * @return The notify subsystem handle. |
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
502 */ |
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
503 void *gaim_notify_get_handle(void); |
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
504 |
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
505 /** |
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
506 * Initializes the notify subsystem. |
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
507 */ |
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
508 void gaim_notify_init(void); |
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
509 |
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
510 /** |
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
511 * Uninitializes the notify subsystem. |
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
512 */ |
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
513 void gaim_notify_uninit(void); |
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
514 |
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
515 /*@}*/ |
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
516 |
216988c717da
[gaim-migrate @ 14429]
Richard Laager <rlaager@wiktel.com>
parents:
11533
diff
changeset
|
517 |
5944
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5522
diff
changeset
|
518 #ifdef __cplusplus |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5522
diff
changeset
|
519 } |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5522
diff
changeset
|
520 #endif |
158196b2db19
[gaim-migrate @ 6385]
Christian Hammond <chipx86@chipx86.com>
parents:
5522
diff
changeset
|
521 |
5437 | 522 #endif /* _GAIM_NOTIFY_H_ */ |