Function

PurpleBuddyicons_node_set_custom_icon_from_file

Declaration [src]

PurpleImage*
purple_buddy_icons_node_set_custom_icon_from_file (
  PurpleBlistNode* node,
  const gchar* filename
)

Description [src]

Sets a custom buddy icon for a blist node.

Convenience wrapper around purple_buddy_icons_node_set_custom_icon. See purple_buddy_icons_node_set_custom_icon().

Parameters

node

Type: PurpleBlistNode

The blist node for which to set a custom icon.

The data is owned by the caller of the function.
filename

Type: const gchar*

The path to the icon to set for the blist node. Use NULL to unset the custom icon.

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.

Return value

Type: PurpleImage

The icon that was set.

The data is owned by the called function.