comparison libpurple/notify.h @ 32308:3e4b6ffbb551

propagate from branch 'im.pidgin.pidgin' (head 64f4eb5c598356fe1b8b9bc376faa66641096eda) to branch 'im.pidgin.pidgin.next.major' (head 950eb2e674f6da789c0132765c4f2d68ccd0d617)

32115:3a3af6ad3166

/**
 * Single column of a search result.
 */
typedef struct
{
	char *title; /**< Title of the column. */

} PurpleNotifySearchColumn;


/**

 * @return The new search results object.
 */
PurpleNotifySearchResults *purple_notify_searchresults_new(void);

/**
 * Returns a newly created search result column object.
 *
 * @param title Title of the column. NOTE: Title will get g_strdup()ed.
 *
 * @return The new search column object.
 */
PurpleNotifySearchColumn *purple_notify_searchresults_column_new(const char *title);

/**
 * Adds a new column to the search result object.
 *
 * @param results The result object to which the column will be added.

32308:3e4b6ffbb551

/**
 * Single column of a search result.
 */
typedef struct
{
	char *title;           /**< Title of the column. */
	gboolean visible;      /**< Should the column be visible to the user. Defaults to TRUE. */

} PurpleNotifySearchColumn;


/**

 * @return The new search results object.
 */
PurpleNotifySearchResults *purple_notify_searchresults_new(void);

/**
 * Returns a newly created search result column object.  The column defaults
 * to being visible.
 *
 * @param title Title of the column. NOTE: Title will get g_strdup()ed.
 *
 * @return The new search column object.
 */
PurpleNotifySearchColumn *purple_notify_searchresults_column_new(const char *title);

/**
 * Sets whether or not a search result column is visible.
 *
 * @param field   The search column object.
 * @param visible TRUE if visible, or FALSE if not.
 */
void purple_notify_searchresult_column_set_visible(PurpleNotifySearchColumn *column, gboolean visible);

/**
 * Returns whether or not a search result column is visible.
 *
 * @param field The search column object.
 *
 * @return TRUE if the search result column is visible. FALSE otherwise.
 */
gboolean purple_notify_searchresult_column_is_visible(const PurpleNotifySearchColumn *column);

/**
 * Adds a new column to the search result object.
 *
 * @param results The result object to which the column will be added.