pidgin/gtkblist.h

changeset 32710
e07993a28f20
parent 32604
8d0a34f26244
child 32790
b95c7c504118
child 32900
9985c4a0e27b
child 33120
f6f1a27ade72
equal deleted inserted replaced
32056:5ecbc7cf4ee1 32710:e07993a28f20
84 84
85 GtkItemFactory *ift; 85 GtkItemFactory *ift;
86 GtkWidget *menutray; /**< The menu tray widget. */ 86 GtkWidget *menutray; /**< The menu tray widget. */
87 GtkWidget *menutrayicon; /**< The menu tray icon. */ 87 GtkWidget *menutrayicon; /**< The menu tray icon. */
88 88
89 /** Caches connection error messages; keys are #PurpleAccount and
90 * values are non-@c NULL <tt>const char *</tt>s containing localised
91 * error messages. (If an account does not have an error, it will not
92 * appear in the table.)
93 * @deprecated in favour of purple_account_get_current_error(), which also
94 * gives you the #PurpleConnectionError value.
95 */
96 GHashTable *connection_errors;
97
98 guint refresh_timer; /**< The timer for refreshing every 30 seconds */ 89 guint refresh_timer; /**< The timer for refreshing every 30 seconds */
99 90
100 guint timeout; /**< The timeout for the tooltip. */ 91 guint timeout; /**< The timeout for the tooltip. */
101 guint drag_timeout; /**< The timeout for expanding contacts on drags */ 92 guint drag_timeout; /**< The timeout for expanding contacts on drags */
102 GdkRectangle tip_rect; /**< This is the bounding rectangle of the 93 GdkRectangle tip_rect; /**< This is the bounding rectangle of the
257 248
258 /** 249 /**
259 * Sets the current theme for Pidgin to use 250 * Sets the current theme for Pidgin to use
260 * 251 *
261 * @param theme the new theme to use 252 * @param theme the new theme to use
262 *
263 * @since 2.6.0
264 */ 253 */
265 void pidgin_blist_set_theme(PidginBlistTheme *theme); 254 void pidgin_blist_set_theme(PidginBlistTheme *theme);
266 255
267 /** 256 /**
268 * Gets Pidgin's current buddy list theme 257 * Gets Pidgin's current buddy list theme
269 * 258 *
270 * @returns the current theme 259 * @returns the current theme
271 *
272 * @since 2.6.0
273 */ 260 */
274 PidginBlistTheme *pidgin_blist_get_theme(void); 261 PidginBlistTheme *pidgin_blist_get_theme(void);
275 262
276 /************************************************************************** 263 /**************************************************************************
277 * @name GTK+ Buddy List sorting functions 264 * @name GTK+ Buddy List sorting functions
368 * TODO: Rename these. 355 * TODO: Rename these.
369 */ 356 */
370 void pidgin_append_blist_node_extended_menu(GtkWidget *menu, PurpleBlistNode *node); 357 void pidgin_append_blist_node_extended_menu(GtkWidget *menu, PurpleBlistNode *node);
371 358
372 /** 359 /**
373 * Was used by the connection API to tell the blist if an account has a
374 * connection error or no longer has a connection error, but the blist now does
375 * this itself with the @ref account-error-changed signal.
376 *
377 * @param account The account that either has a connection error
378 * or no longer has a connection error.
379 * @param message The connection error message, or NULL if this
380 * account is no longer in an error state.
381 * @deprecated There was no good reason for code other than gtkconn to call
382 * this.
383 */
384 void pidgin_blist_update_account_error_state(PurpleAccount *account, const char *message);
385
386 /**
387 * Sets a headline notification 360 * Sets a headline notification
388 * 361 *
389 * This is currently used for mail notification, but could theoretically be used for anything. 362 * This is currently used for mail notification, but could theoretically be used for anything.
390 * Only the most recent headline will be shown. 363 * Only the most recent headline will be shown.
391 * 364 *
403 * 376 *
404 * @param buddy The buddy to return markup from 377 * @param buddy The buddy to return markup from
405 * @param selected Whether this buddy is selected. If TRUE, the markup will not change the color. 378 * @param selected Whether this buddy is selected. If TRUE, the markup will not change the color.
406 * @param aliased TRUE to return the appropriate alias of this buddy, FALSE to return its username and status information 379 * @param aliased TRUE to return the appropriate alias of this buddy, FALSE to return its username and status information
407 * @return The markup for this buddy 380 * @return The markup for this buddy
408 *
409 * @since 2.1.0
410 */ 381 */
411 gchar *pidgin_blist_get_name_markup(PurpleBuddy *buddy, gboolean selected, gboolean aliased); 382 gchar *pidgin_blist_get_name_markup(PurpleBuddy *buddy, gboolean selected, gboolean aliased);
412 383
413 /** 384 /**
414 * Creates the Buddy List tooltip at the current pointer location for the given buddy list node. 385 * Creates the Buddy List tooltip at the current pointer location for the given buddy list node.
416 * This tooltip will be destroyed the next time this function is called, or when XXXX 387 * This tooltip will be destroyed the next time this function is called, or when XXXX
417 * is called 388 * is called
418 * 389 *
419 * @param node The buddy list node to show a tooltip for 390 * @param node The buddy list node to show a tooltip for
420 * @param widget The widget to draw the tooltip on 391 * @param widget The widget to draw the tooltip on
421 *
422 * @since 2.1.0
423 */ 392 */
424 void pidgin_blist_draw_tooltip(PurpleBlistNode *node, GtkWidget *widget); 393 void pidgin_blist_draw_tooltip(PurpleBlistNode *node, GtkWidget *widget);
425 394
426 /** 395 /**
427 * Destroys the current (if any) Buddy List tooltip 396 * Destroys the current (if any) Buddy List tooltip
428 *
429 * @since 2.1.0
430 */ 397 */
431 void pidgin_blist_tooltip_destroy(void); 398 void pidgin_blist_tooltip_destroy(void);
432 399
433 400
434 #endif /* _PIDGINBLIST_H_ */ 401 #endif /* _PIDGINBLIST_H_ */

mercurial