comparison src/savedstatuses.h @ 12688:473c23442a36

[gaim-migrate @ 15031] Add the notion of "popular" saved statuses. This lets us show 6 recently used/popular statuses in the context menu for the docklet. Eventually I'll add the same list to the status box--but that's a little more work. If someone else wants to tackle it before I have a chance to feel free (and let me know!) Does this look ok to everyone (the docklet menu changes)? Would it be better if it was a submenu? Or if it was labeled? It'd be cool if the icons reflected the status. Oh, and I just remembered that the menu items don't actually work yet... but that's not too hard, I think I can get to that tonight committer: Tailor Script <[e-mail]>

12687:88ccc3603163

 * @return A list of saved statuses.
 */
const GList *gaim_savedstatuses_get_all(void);

/**
 * Returns the currently selected saved status.
 *
 * @return A pointer to the in-use GaimSavedStatus.
 */
GaimSavedStatus *gaim_savedstatus_get_current(void);

12688:473c23442a36

 * @return A list of saved statuses.
 */
const GList *gaim_savedstatuses_get_all(void);

/**
 * Returns the n most popular saved statuses.  "Popularity" is
 * determined by when the last time a saved_status was used and
 * how many times it has been used.
 *
 * @param how_many The maximum number of saved statuses
 *                 to return, or '0' to get all saved
 *                 statuses sorted by popularity.
 * @return A linked list containing at most how_many
 *         GaimSavedStatuses.  This list should be
 *         g_list_free'd by the caller (but the
 *         GaimSavedStatuses must not be free'd).
 */
GList *gaim_savedstatuses_get_popular(unsigned int how_many);

/**
 * Returns the currently selected saved status.
 *
 * @return A pointer to the in-use GaimSavedStatus.
 */
GaimSavedStatus *gaim_savedstatus_get_current(void);