5228
|
1 /**
|
5248
|
2 * @file gtkblist.h GTK+ Buddy List API
|
5228
|
3 * @ingroup gtkui
|
|
4 *
|
|
5 * gaim
|
|
6 *
|
|
7 * Copyright (C) 2002-2003, Sean Egan <sean.egan@binghamton.edu>
|
|
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_LIST_H_
|
|
25 #define _GAIM_GTK_LIST_H_
|
|
26
|
|
27 enum {
|
|
28 STATUS_ICON_COLUMN,
|
|
29 STATUS_ICON_VISIBLE_COLUMN,
|
|
30 NAME_COLUMN,
|
|
31 WARNING_COLUMN,
|
|
32 IDLE_COLUMN,
|
|
33 BUDDY_ICON_COLUMN,
|
|
34 NODE_COLUMN,
|
|
35 BLIST_COLUMNS
|
|
36 };
|
|
37
|
|
38 typedef enum {
|
|
39 GAIM_STATUS_ICON_LARGE,
|
|
40 GAIM_STATUS_ICON_SMALL
|
|
41 } GaimStatusIconSize;
|
|
42 /**************************************************************************
|
|
43 * @name Structures
|
|
44 **************************************************************************/
|
|
45 /**
|
|
46 * Like, everything you need to know about the gtk buddy list
|
|
47 */
|
|
48 struct gaim_gtk_buddy_list {
|
|
49 GtkWidget *window;
|
|
50 GtkWidget *vbox; /**< This is the vbox that everything gets packed into. Your plugin might
|
|
51 want to pack something in it itself. Go, plugins! */
|
|
52
|
|
53 GtkWidget *treeview; /**< It's a treeview... d'uh. */
|
|
54 GtkTreeStore *treemodel; /**< This is the treemodel. */
|
|
55 GtkTreeViewColumn *idle_column,
|
|
56 *warning_column,
|
|
57 *buddy_icon_column;
|
|
58
|
|
59 GtkWidget *bpmenu; /**< The buddy pounce menu. */
|
|
60
|
|
61 GtkWidget *bbox; /**< A Button Box. */
|
|
62 GtkTooltips *tooltips; /**< Tooltips for the buttons. */
|
|
63
|
|
64 guint refresh_timer; /**< The timer for refreshing every 30 seconds */
|
|
65
|
|
66 guint timeout; /**< The timeout for the tooltip. */
|
|
67 GdkRectangle rect; /**< This is the bounding rectangle of the
|
|
68 cell we're currently hovering over. This is
|
|
69 used for tooltips. */
|
|
70 GtkWidget *tipwindow; /**< The window used by the tooltip */
|
|
71
|
|
72 GaimBlistNode *selected_node; /**< The currently selected node */
|
|
73 };
|
|
74
|
|
75 #define GAIM_GTK_BLIST(list) ((struct gaim_gtk_buddy_list *)(list)->ui_data)
|
|
76 #define GAIM_IS_GTK_BLIST(list) \
|
|
77 ((list)->ui_ops == gaim_get_gtk_blist_ui_ops())
|
|
78
|
|
79 /**************************************************************************
|
5422
|
80 * @name GTK+ Buddy List API
|
5228
|
81 **************************************************************************/
|
|
82 /**
|
|
83 * Returns the UI operations structure for the buddy list.
|
|
84 *
|
|
85 * @return The GTK list operations structure.
|
|
86 */
|
|
87 struct gaim_blist_ui_ops *gaim_get_gtk_blist_ui_ops(void);
|
|
88
|
|
89 /**
|
|
90 * Returns the base image to represent the account, based on the currently selected theme
|
|
91 *
|
|
92 * @param account The account.
|
|
93 *
|
|
94 * @return The icon
|
|
95 */
|
|
96 GdkPixbuf *create_prpl_icon(struct gaim_account *account);
|
|
97
|
|
98 /**
|
|
99 * Refreshes all the nodes of the buddy list.
|
|
100 * This should only be called when something changes to affect most of the nodes (such as a ui preference changing)
|
|
101 *
|
|
102 * @param list This is the core list that gets updated from
|
|
103 */
|
|
104 void gaim_gtk_blist_refresh(struct gaim_buddy_list *list);
|
|
105
|
|
106 /**
|
|
107 * Tells the buddy list to update its toolbar based on the preferences
|
|
108 *
|
|
109 */
|
|
110 void gaim_gtk_blist_update_toolbar();
|
|
111
|
|
112 /**
|
|
113 * Useful for the docklet plugin and also for the win32 tray icon
|
|
114 * This is called when one of those is clicked--it will show/hide the
|
|
115 * buddy list/login window--depending on which is active
|
|
116 */
|
|
117 void gaim_gtk_blist_docklet_toggle();
|
|
118 void gaim_gtk_blist_docklet_add();
|
|
119 void gaim_gtk_blist_docklet_remove();
|
|
120 void gaim_gtk_blist_update_columns();
|
5411
|
121 void gaim_gtk_blist_update_refresh_timeout();
|
5228
|
122
|
|
123 /**
|
|
124 * Useful for the buddy ticker
|
|
125 */
|
5234
|
126 GdkPixbuf *gaim_gtk_blist_get_status_icon(GaimBlistNode *node,
|
5228
|
127 GaimStatusIconSize size);
|
|
128
|
5422
|
129 /**************************************************************************
|
|
130 * @name GTK+ Buddy List sorting functions
|
|
131 **************************************************************************/
|
|
132
|
|
133 typedef GtkTreeIter (*gaim_gtk_blist_sort_function)(GaimBlistNode *new, struct gaim_buddy_list *blist, GtkTreeIter group, GtkTreeIter *cur);
|
|
134
|
|
135 extern GSList *gaim_gtk_blist_sort_methods;
|
|
136
|
|
137 struct gaim_gtk_blist_sort_method {
|
|
138 char *name;
|
|
139 gaim_gtk_blist_sort_function func;
|
|
140 };
|
|
141
|
|
142 /**
|
|
143 * Registers a buddy list sorting method.
|
|
144 *
|
|
145 * @param name The method's name.
|
|
146 * @param func A pointer to the function.
|
|
147 *
|
|
148 */
|
|
149 void gaim_gtk_blist_sort_method_reg(const char *name, gaim_gtk_blist_sort_function func);
|
|
150
|
|
151 /**
|
|
152 * Unregisters a buddy list sorting method.
|
|
153 *
|
|
154 * @param name The method's name
|
|
155 */
|
|
156 void gaim_gtk_blist_sort_method_unreg(const char *name);
|
|
157
|
|
158 /**
|
|
159 * Sets a buddy list sorting method.
|
|
160 *
|
|
161 * @param name The method's name.
|
|
162 */
|
|
163 void gaim_gtk_blist_sort_method_set(const char *name);
|
|
164
|
|
165 /**
|
|
166 * Sets up the programs default sort methods
|
|
167 */
|
|
168 void gaim_gtk_blist_setup_sort_methods();
|
|
169
|
|
170
|
|
171
|
5228
|
172 #endif /* _GAIM_GTK_LIST_H_ */
|