Mercurial > pidgin
comparison libpurple/request.h @ 21221:e98c08afb706
Changelog some of the stuff.
author | Sadrul Habib Chowdhury <imadil@gmail.com> |
---|---|
date | Fri, 12 Oct 2007 02:57:26 +0000 |
parents | 9faacf8aa044 |
children | 0b67d509a305 ad718740aa71 |
comparison
equal
deleted
inserted
replaced
21220:b1fa7765ca4b | 21221:e98c08afb706 |
---|---|
1183 * @param flag Flags dictating what kind of blist nodes should be | 1183 * @param flag Flags dictating what kind of blist nodes should be |
1184 * included in the request field. | 1184 * included in the request field. |
1185 * @param selected A list of PurpleBlistNode's to select by default, or @c NULL. | 1185 * @param selected A list of PurpleBlistNode's to select by default, or @c NULL. |
1186 * | 1186 * |
1187 * @return The new field. | 1187 * @return The new field. |
1188 * | |
1189 * @since 2.3.0 | |
1188 */ | 1190 */ |
1189 PurpleRequestField *purple_request_field_blist_nodes_new(const char *id, const char *text, | 1191 PurpleRequestField *purple_request_field_blist_nodes_new(const char *id, const char *text, |
1190 PurpleRequestBlistFlags flag, GList *selected); | 1192 PurpleRequestBlistFlags flag, GList *selected); |
1191 | 1193 |
1192 /** | 1194 /** |
1194 * | 1196 * |
1195 * @param field The request field. | 1197 * @param field The request field. |
1196 * @param filter The filter function. | 1198 * @param filter The filter function. |
1197 * | 1199 * |
1198 * @return The old filter function, or @c NULL if there was none. | 1200 * @return The old filter function, or @c NULL if there was none. |
1201 * | |
1202 * @since 2.3.0 | |
1199 */ | 1203 */ |
1200 PurpleFilterBlistFunc purple_request_field_blist_set_filter(PurpleRequestField *field, PurpleFilterBlistFunc filter); | 1204 PurpleFilterBlistFunc purple_request_field_blist_set_filter(PurpleRequestField *field, PurpleFilterBlistFunc filter); |
1201 | 1205 |
1202 /** | 1206 /** |
1203 * Get the filter function for the request field. | 1207 * Get the filter function for the request field. |
1204 * | 1208 * |
1205 * @param field The request field. | 1209 * @param field The request field. |
1206 * | 1210 * |
1207 * @return The filter function, or @c NULL if there isn't any. | 1211 * @return The filter function, or @c NULL if there isn't any. |
1212 * | |
1213 * @since 2.3.0 | |
1208 */ | 1214 */ |
1209 PurpleFilterBlistFunc purple_request_field_blist_get_filter(const PurpleRequestField *field); | 1215 PurpleFilterBlistFunc purple_request_field_blist_get_filter(const PurpleRequestField *field); |
1210 | 1216 |
1211 /** | 1217 /** |
1212 * Add a PurpleBlistNode to the selected list. | 1218 * Add a PurpleBlistNode to the selected list. |
1213 * | 1219 * |
1214 * @param field The request field. | 1220 * @param field The request field. |
1215 * @param node The buddylist node to add to the list. | 1221 * @param node The buddylist node to add to the list. |
1216 * | 1222 * |
1217 * @return @c TRUE if the node is added to the list, @c FALSE if it was already in the list. | 1223 * @return @c TRUE if the node is added to the list, @c FALSE if it was already in the list. |
1224 * | |
1225 * @since 2.3.0 | |
1218 */ | 1226 */ |
1219 gboolean purple_request_field_blist_add(PurpleRequestField *field, PurpleBlistNode *node); | 1227 gboolean purple_request_field_blist_add(PurpleRequestField *field, PurpleBlistNode *node); |
1220 | 1228 |
1221 /** | 1229 /** |
1222 * Remove a PurpleBlistNode from the selected list. | 1230 * Remove a PurpleBlistNode from the selected list. |
1223 * | 1231 * |
1224 * @param field The request field. | 1232 * @param field The request field. |
1225 * @param node The buddylist node to remove from the list. | 1233 * @param node The buddylist node to remove from the list. |
1226 * | 1234 * |
1227 * @return @c TRUE if the node is removed from the list, @c FALSE if the node is not in the list. | 1235 * @return @c TRUE if the node is removed from the list, @c FALSE if the node is not in the list. |
1236 * | |
1237 * @since 2.3.0 | |
1228 */ | 1238 */ |
1229 gboolean purple_request_field_blist_remove(PurpleRequestField *field, PurpleBlistNode *node); | 1239 gboolean purple_request_field_blist_remove(PurpleRequestField *field, PurpleBlistNode *node); |
1230 | 1240 |
1231 /** | 1241 /** |
1232 * Set the list of selected nodes in the request field. | 1242 * Set the list of selected nodes in the request field. |
1233 * | 1243 * |
1234 * @param field The request field. | 1244 * @param field The request field. |
1235 * @param selecteds The list of selected PurpleBlistNode's. Note that the request field | 1245 * @param selecteds The list of selected PurpleBlistNode's. Note that the request field |
1236 * becomes the owner of the list, and so the caller should not modify it. | 1246 * becomes the owner of the list, and so the caller should not modify it. |
1247 * | |
1248 * @since 2.3.0 | |
1237 */ | 1249 */ |
1238 void purple_request_field_blist_set_selection_list(PurpleRequestField *field, GList *selecteds); | 1250 void purple_request_field_blist_set_selection_list(PurpleRequestField *field, GList *selecteds); |
1239 | 1251 |
1240 /** | 1252 /** |
1241 * Get a list of the selected buddylist nodes. | 1253 * Get a list of the selected buddylist nodes. |
1242 * | 1254 * |
1243 * @param field The request field. | 1255 * @param field The request field. |
1244 * | 1256 * |
1245 * @return A GList of PurpleBlistNode's. | 1257 * @return A GList of PurpleBlistNode's. |
1258 * | |
1259 * @since 2.3.0 | |
1246 */ | 1260 */ |
1247 GList *purple_request_field_blist_get_selection_list(const PurpleRequestField *field); | 1261 GList *purple_request_field_blist_get_selection_list(const PurpleRequestField *field); |
1248 | 1262 |
1249 /*@}*/ | 1263 /*@}*/ |
1250 | 1264 |