| 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. |