pidgin/gtksavedstatuses.h

branch
soc.2013.gobjectification.plugins
changeset 37034
9d6765962b22
parent 37023
d9bcdc9a91e6
child 37053
e8959e0f6a37
equal deleted inserted replaced
37033:ce8b96a22ebe 37034:9d6765962b22
43 43
44 /** 44 /**
45 * Shows a status editor (used for adding a new saved status or 45 * Shows a status editor (used for adding a new saved status or
46 * editing an already existing saved status). 46 * editing an already existing saved status).
47 * 47 *
48 * @param edit TRUE if we want to edit an existing saved 48 * @edit: TRUE if we want to edit an existing saved
49 * status or FALSE to create a new one. You 49 * status or FALSE to create a new one. You
50 * can not edit transient statuses--they don't 50 * can not edit transient statuses--they don't
51 * have titles. If you want to edit a transient 51 * have titles. If you want to edit a transient
52 * status, set this to FALSE and seed the dialog 52 * status, set this to FALSE and seed the dialog
53 * with the transient status using the status 53 * with the transient status using the status
54 * parameter to this function. 54 * parameter to this function.
55 * @param status If edit is TRUE then this should be a 55 * @status: If edit is TRUE then this should be a
56 * pointer to the PurpleSavedStatus to edit. 56 * pointer to the PurpleSavedStatus to edit.
57 * If edit is FALSE then this can be NULL, 57 * If edit is FALSE then this can be NULL,
58 * or you can pass in a saved status to 58 * or you can pass in a saved status to
59 * seed the initial values of the new status. 59 * seed the initial values of the new status.
60 */ 60 */
62 62
63 /** 63 /**
64 * Creates a dropdown menu of saved statuses and calls a callback 64 * Creates a dropdown menu of saved statuses and calls a callback
65 * when one is selected 65 * when one is selected
66 * 66 *
67 * @param status The default saved_status to show as 'selected' 67 * @status: The default saved_status to show as 'selected'
68 * @param callback The callback to call when the selection changes 68 * @callback: The callback to call when the selection changes
69 * @return The menu widget 69 * Returns: The menu widget
70 */ 70 */
71 GtkWidget *pidgin_status_menu(PurpleSavedStatus *status, GCallback callback); 71 GtkWidget *pidgin_status_menu(PurpleSavedStatus *status, GCallback callback);
72 72
73 /** 73 /**
74 * Returns the GTK+ status handle. 74 * Returns the GTK+ status handle.
75 * 75 *
76 * @return The handle to the GTK+ status system. 76 * Returns: The handle to the GTK+ status system.
77 */ 77 */
78 void *pidgin_status_get_handle(void); 78 void *pidgin_status_get_handle(void);
79 79
80 /** 80 /**
81 * Initializes the GTK+ status system. 81 * Initializes the GTK+ status system.

mercurial