comparison libpurple/buddyicon.h @ 24074:2ecdd0403dc1

Don't try to read data from a NULL filename in purple_buddy_icons_node_set_custom_icon_from_file. Also document that you can use NULL to unset the icon. Fixes #6998.
author Elliott Sales de Andrade <qulogic@pidgin.im>
date Sun, 07 Sep 2008 19:58:04 +0000
parents d3fb9d9b57e2
children 8282911d5e17
comparison
equal deleted inserted replaced
24073:eb4d0636cf88 24074:2ecdd0403dc1
306 * This function will deal with saving a record of the icon, caching the data, 306 * This function will deal with saving a record of the icon, caching the data,
307 * etc. 307 * etc.
308 * 308 *
309 * @param node The blist node for which to set a custom icon. 309 * @param node The blist node for which to set a custom icon.
310 * @param icon_data The image data of the icon, which the buddy icon code will 310 * @param icon_data The image data of the icon, which the buddy icon code will
311 * free. 311 * free. Use NULL to unset the icon.
312 * @param icon_len The length of the data in @a icon_data. 312 * @param icon_len The length of the data in @a icon_data.
313 * 313 *
314 * @return The icon that was set. The caller does NOT own a reference to this, 314 * @return The icon that was set. The caller does NOT own a reference to this,
315 * and must call purple_imgstore_ref() if it wants one. 315 * and must call purple_imgstore_ref() if it wants one.
316 * @since 2.5.0 316 * @since 2.5.0
324 * 324 *
325 * Convenience wrapper around purple_buddy_icons_node_set_custom_icon. 325 * Convenience wrapper around purple_buddy_icons_node_set_custom_icon.
326 * @see purple_buddy_icons_node_set_custom_icon() 326 * @see purple_buddy_icons_node_set_custom_icon()
327 * 327 *
328 * @param node The blist node for which to set a custom icon. 328 * @param node The blist node for which to set a custom icon.
329 * @param filename The path to the icon to set for the blist node. 329 * @param filename The path to the icon to set for the blist node. Use NULL
330 * to unset the custom icon.
330 * 331 *
331 * @return The icon that was set. The caller does NOT own a reference to this, 332 * @return The icon that was set. The caller does NOT own a reference to this,
332 * and must call purple_imgstore_ref() if it wants one. 333 * and must call purple_imgstore_ref() if it wants one.
333 * @since 2.5.0 334 * @since 2.5.0
334 */ 335 */