pidgin/gtkutils.h

changeset 40991
d92defc9ba95
parent 40704
09fc97ff0b52
child 41058
18f3ea2e7e6d
equal deleted inserted replaced
40990:7988932faf91 40991:d92defc9ba95
414 * Returns: The converted image data, or %NULL if an error occurred. 414 * Returns: The converted image data, or %NULL if an error occurred.
415 */ 415 */
416 gpointer pidgin_convert_buddy_icon(PurpleProtocol *protocol, const char *path, size_t *len); 416 gpointer pidgin_convert_buddy_icon(PurpleProtocol *protocol, const char *path, size_t *len);
417 417
418 /** 418 /**
419 * PidginUtilMiniDialogCallback:
420 *
421 * The type of callbacks passed to pidgin_make_mini_dialog().
422 */
423 typedef void (*PidginUtilMiniDialogCallback)(gpointer user_data, GtkButton *button);
424
425 /**
426 * pidgin_make_mini_dialog:
427 * @handle: The #PurpleConnection to which this mini-dialog
428 * refers, or %NULL if it does not refer to a
429 * connection. If @handle is supplied, the mini-dialog
430 * will be automatically removed and destroyed when the
431 * connection signs off.
432 * @stock_id: The ID of a stock image to use in the mini dialog.
433 * @primary: The primary text
434 * @secondary: The secondary text, or %NULL for no description.
435 * @user_data: Data to pass to the callbacks
436 * @...: a %NULL-terminated list of button labels
437 * (<type>char *</type>) and callbacks
438 * (#PidginUtilMiniDialogCallback). @user_data will be
439 * passed as the first argument. (Callbacks may lack a
440 * second argument, or be %NULL to take no action when
441 * the corresponding button is pressed.) When a button is
442 * pressed, the callback (if any) will be called; when
443 * the callback returns the dialog will be destroyed.
444 *
445 * Creates a #PidginMiniDialog, tied to a #PurpleConnection, suitable for
446 * embedding in the buddy list scrollbook with pidgin_blist_add_alert().
447 *
448 * See <link linkend="pidgin-pidginstock">Stock Resources</link>.
449 *
450 * Returns: (transfer full): A #PidginMiniDialog, suitable for passing to
451 * pidgin_blist_add_alert().
452 */
453 GtkWidget *pidgin_make_mini_dialog(PurpleConnection *handle,
454 const char* stock_id, const char *primary, const char *secondary,
455 void *user_data, ...) G_GNUC_NULL_TERMINATED;
456
457 /**
458 * pidgin_make_mini_dialog_with_custom_icon:
459 * @custom_icon: A custom GdkPixbuf to use.
460 * @primary: The primary text
461 * @secondary: The secondary text, or %NULL for no description.
462 * @user_data: Data to pass to the callbacks
463 * @...: a %NULL-terminated list of button labels
464 * (<type>char *</type>) and callbacks
465 * (#PidginUtilMiniDialogCallback). @user_data will be
466 * passed as the first argument. (Callbacks may lack a
467 * second argument, or be %NULL to take no action when
468 * the corresponding button is pressed.) When a button is
469 * pressed, the callback (if any) will be called; when
470 * the callback returns the dialog will be destroyed.
471 *
472 * Does exactly what pidgin_make_mini_dialog() does, except you can specify
473 * a custom icon for the dialog.
474 *
475 * Returns: (transfer full): A #PidginMiniDialog, suitable for passing to
476 * pidgin_blist_add_alert().
477 */
478 GtkWidget *pidgin_make_mini_dialog_with_custom_icon(PurpleConnection *gc,
479 GdkPixbuf *custom_icon,
480 const char *primary,
481 const char *secondary,
482 void *user_data,
483 ...) G_GNUC_NULL_TERMINATED;
484
485 /**
486 * pidgin_tree_view_search_equal_func: 419 * pidgin_tree_view_search_equal_func:
487 * 420 *
488 * This is a callback function to be used for Ctrl+F searching in treeviews. 421 * This is a callback function to be used for Ctrl+F searching in treeviews.
489 * Sample Use: 422 * Sample Use:
490 * gtk_tree_view_set_search_equal_func(treeview, 423 * gtk_tree_view_set_search_equal_func(treeview,

mercurial