Mercurial > pidgin
annotate finch/gntblist.h @ 20789:6736c1168c50
Leak fix.
author | Daniel Atallah <daniel.atallah@gmail.com> |
---|---|
date | Fri, 05 Oct 2007 16:22:03 +0000 |
parents | 6bf32c9e15a7 |
children | acf284962b40 |
rev | line source |
---|---|
15817 | 1 /** |
2 * @file gntblist.h GNT BuddyList API | |
16194
0f0832c13fcb
Rename the Doxygen group from gntui to finch and define the finch group
Richard Laager <rlaager@wiktel.com>
parents:
15870
diff
changeset
|
3 * @ingroup finch |
20074
6bf32c9e15a7
remove gpl boilerplate from doxygen docs
Sean Egan <seanegan@gmail.com>
parents:
19681
diff
changeset
|
4 */ |
6bf32c9e15a7
remove gpl boilerplate from doxygen docs
Sean Egan <seanegan@gmail.com>
parents:
19681
diff
changeset
|
5 |
6bf32c9e15a7
remove gpl boilerplate from doxygen docs
Sean Egan <seanegan@gmail.com>
parents:
19681
diff
changeset
|
6 /* finch |
15817 | 7 * |
15870
66dff3dfdea6
Re-sed the copyright notices so they don't all talk about Purple.
Richard Laager <rlaager@wiktel.com>
parents:
15822
diff
changeset
|
8 * Finch is the legal property of its developers, whose names are too numerous |
15817 | 9 * to list here. Please refer to the COPYRIGHT file distributed with this |
10 * source distribution. | |
11 * | |
12 * This program is free software; you can redistribute it and/or modify | |
13 * it under the terms of the GNU General Public License as published by | |
14 * the Free Software Foundation; either version 2 of the License, or | |
15 * (at your option) any later version. | |
16 * | |
17 * This program is distributed in the hope that it will be useful, | |
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
20 * GNU General Public License for more details. | |
21 * | |
22 * You should have received a copy of the GNU General Public License | |
23 * along with this program; if not, write to the Free Software | |
19681
44b4e8bd759b
The FSF changed its address a while ago; our files were out of date.
John Bailey <rekkanoryo@rekkanoryo.org>
parents:
17804
diff
changeset
|
24 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA |
15817 | 25 */ |
26 #ifndef _GNT_BLIST_H | |
27 #define _GNT_BLIST_H | |
28 | |
29 #include "blist.h" | |
30 | |
31 /********************************************************************** | |
32 * @name GNT BuddyList API | |
33 **********************************************************************/ | |
34 /*@{*/ | |
35 | |
36 /** | |
37 * Get the ui-functions. | |
38 * | |
15822 | 39 * @return The PurpleBlistUiOps structure populated with the appropriate functions. |
15817 | 40 */ |
15822 | 41 PurpleBlistUiOps * finch_blist_get_ui_ops(void); |
15817 | 42 |
43 /** | |
44 * Perform necessary initializations. | |
45 */ | |
46 void finch_blist_init(void); | |
47 | |
48 /** | |
49 * Perform necessary uninitializations. | |
50 */ | |
51 void finch_blist_uninit(void); | |
52 | |
53 /** | |
54 * Show the buddy list. | |
55 */ | |
56 void finch_blist_show(void); | |
57 | |
58 /** | |
59 * Get the position of the buddy list. | |
60 * | |
61 * @param x The x-coordinate is set here if not @ NULL. | |
62 * @param y The y-coordinate is set here if not @c NULL. | |
63 * | |
64 * @return Returns @c TRUE if the values were set, @c FALSE otherwise. | |
65 */ | |
66 gboolean finch_blist_get_position(int *x, int *y); | |
67 | |
68 /** | |
69 * Set the position of the buddy list. | |
70 * | |
71 * @param x The x-coordinate of the buddy list. | |
72 * @param y The y-coordinate of the buddy list. | |
73 */ | |
74 void finch_blist_set_position(int x, int y); | |
75 | |
76 /** | |
77 * Get the size of the buddy list. | |
78 * | |
79 * @param width The width is set here if not @ NULL. | |
80 * @param height The height is set here if not @c NULL. | |
81 * | |
82 * @return Returns @c TRUE if the values were set, @c FALSE otherwise. | |
83 */ | |
84 gboolean finch_blist_get_size(int *width, int *height); | |
85 | |
86 /** | |
87 * Set the size of the buddy list. | |
88 * | |
89 * @param width The width of the buddy list. | |
90 * @param height The height of the buddy list. | |
91 */ | |
92 void finch_blist_set_size(int width, int height); | |
93 | |
17750
319bcb73eb4e
Use utility functions to get user info. Closes #964.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16194
diff
changeset
|
94 /** |
319bcb73eb4e
Use utility functions to get user info. Closes #964.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16194
diff
changeset
|
95 * Get information about a user. Show immediate feedback. |
319bcb73eb4e
Use utility functions to get user info. Closes #964.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16194
diff
changeset
|
96 * |
319bcb73eb4e
Use utility functions to get user info. Closes #964.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16194
diff
changeset
|
97 * @param conn The connection to get information fro |
319bcb73eb4e
Use utility functions to get user info. Closes #964.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16194
diff
changeset
|
98 * @param name The user to get information about. |
17804
464840043c66
Show information about the user requesting authorization.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17750
diff
changeset
|
99 * |
464840043c66
Show information about the user requesting authorization.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17750
diff
changeset
|
100 * @return Returns the ui-handle for the userinfo notification. |
17750
319bcb73eb4e
Use utility functions to get user info. Closes #964.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16194
diff
changeset
|
101 */ |
17804
464840043c66
Show information about the user requesting authorization.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17750
diff
changeset
|
102 gpointer finch_retrieve_user_info(PurpleConnection *conn, const char *name); |
17750
319bcb73eb4e
Use utility functions to get user info. Closes #964.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
16194
diff
changeset
|
103 |
15817 | 104 /*@}*/ |
105 | |
106 #endif |