comparison libpurple/notify.h @ 32303:63fb41aa3dbe

Add API: * purple_notify_searchresult_column_set_visible * purple_notify_searchresult_column_is_visible This allows columns to be defined in the search-results, but that are not visible to the user. These columns can, for example, be used to store values associated with the selected-row that are required in the search-result callback.
author andrew.victor@mxit.com
date Tue, 03 May 2011 20:55:39 +0000
parents 0123c69ec0e5
children ea4bb5fe1fdc
comparison
equal deleted inserted replaced
32302:3448f64d197c 32303:63fb41aa3dbe
109 /** 109 /**
110 * Single column of a search result. 110 * Single column of a search result.
111 */ 111 */
112 typedef struct 112 typedef struct
113 { 113 {
114 char *title; /**< Title of the column. */ 114 char *title; /**< Title of the column. */
115 gboolean visible;
115 116
116 } PurpleNotifySearchColumn; 117 } PurpleNotifySearchColumn;
117 118
118 119
119 /** 120 /**
271 * @param title Title of the column. NOTE: Title will get g_strdup()ed. 272 * @param title Title of the column. NOTE: Title will get g_strdup()ed.
272 * 273 *
273 * @return The new search column object. 274 * @return The new search column object.
274 */ 275 */
275 PurpleNotifySearchColumn *purple_notify_searchresults_column_new(const char *title); 276 PurpleNotifySearchColumn *purple_notify_searchresults_column_new(const char *title);
277
278 /**
279 * Sets whether or not a search result column is visible.
280 *
281 * @param field The search column object.
282 * @param visible TRUE if visible, or FALSE if not.
283 */
284 void purple_notify_searchresult_column_set_visible(PurpleNotifySearchColumn *column, gboolean visible);
285
286 /**
287 * Returns whether or not a search result column is visible.
288 *
289 * @param field The search column object.
290 *
291 * @return TRUE if the search result column is visible. FALSE otherwise.
292 */
293 gboolean purple_notify_searchresult_column_is_visible(const PurpleNotifySearchColumn *column);
276 294
277 /** 295 /**
278 * Adds a new column to the search result object. 296 * Adds a new column to the search result object.
279 * 297 *
280 * @param results The result object to which the column will be added. 298 * @param results The result object to which the column will be added.