FolksAvatarDetails

FolksAvatarDetails — Interface for classes which represent contacts which have an avatar (pictorial representation), such as FolksPersona and FolksIndividual.

Synopsis

void                folks_avatar_details_change_avatar  (FolksAvatarDetails *self,
                                                         GLoadableIcon *avatar,
                                                         GAsyncReadyCallback _callback_,
                                                         gpointer _user_data_);
void                folks_avatar_details_change_avatar_finish
                                                        (FolksAvatarDetails *self,
                                                         GAsyncResult *_res_,
                                                         GError **error);
GLoadableIcon *     folks_avatar_details_get_avatar     (FolksAvatarDetails *self);
void                folks_avatar_details_set_avatar     (FolksAvatarDetails *self,
                                                         GLoadableIcon *value);
                    FolksAvatarDetails;

Object Hierarchy

  GInterface
   +----FolksAvatarDetails

Prerequisites

FolksAvatarDetails requires GObject.

Known Implementations

FolksAvatarDetails is implemented by FolksIndividual.

Properties

  "avatar"                   GLoadableIcon*        : Read / Write

Description

Details

folks_avatar_details_change_avatar ()

void                folks_avatar_details_change_avatar  (FolksAvatarDetails *self,
                                                         GLoadableIcon *avatar,
                                                         GAsyncReadyCallback _callback_,
                                                         gpointer _user_data_);

Change the contact's avatar.

It's preferred to call this rather than setting "avatar" directly, as this method gives error notification and will only return once the avatar has been written to the relevant backing store (or the operation's failed).

See also: folks_avatar_details_change_avatar_finish()

self :

the FolksAvatarDetails instance

avatar :

the new avatar (or `null` to unset the avatar). [in][allow-none]

_callback_ :

callback to call when the request is satisfied. [scope async]

_user_data_ :

the data to pass to _callback_ function. [closure]

Since 0.6.2


folks_avatar_details_change_avatar_finish ()

void                folks_avatar_details_change_avatar_finish
                                                        (FolksAvatarDetails *self,
                                                         GAsyncResult *_res_,
                                                         GError **error);

Change the contact's avatar.

It's preferred to call this rather than setting "avatar" directly, as this method gives error notification and will only return once the avatar has been written to the relevant backing store (or the operation's failed).

See also: folks_avatar_details_change_avatar()

self :

the FolksAvatarDetails instance

_res_ :

a GAsyncResult

error :

location to store the error occuring, or NULL to ignore. [error-domains FolksPropertyError]

Since 0.6.2


folks_avatar_details_get_avatar ()

GLoadableIcon *     folks_avatar_details_get_avatar     (FolksAvatarDetails *self);

self :

the FolksAvatarDetails instance to query

Returns :

the value of the "avatar" property

folks_avatar_details_set_avatar ()

void                folks_avatar_details_set_avatar     (FolksAvatarDetails *self,
                                                         GLoadableIcon *value);

self :

the FolksAvatarDetails instance to modify

value :

the new value of the "avatar" property

FolksAvatarDetails

typedef struct _FolksAvatarDetails FolksAvatarDetails;

Interface for classes which represent contacts which have an avatar (pictorial representation), such as FolksPersona and FolksIndividual.

Property Details

The "avatar" property

  "avatar"                   GLoadableIcon*        : Read / Write

An avatar for the contact.

An avatar is a small image file which represents the contact. It may be `null` if unset. Otherwise, the image data may be asynchronously loaded using the methods of the GLoadableIcon implementation.

Since 0.6.0