folks_favourite_details_change_is_favourite ()

void
folks_favourite_details_change_is_favourite
                               (FolksFavouriteDetails *self,
                                gboolean is_favourite,
                                GAsyncReadyCallback _callback_,
                                gpointer _user_data_);

Change whether the contact is a user-defined favourite.

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

FolksPropertyError will be returned in error

if setting the favouriteness failed

See also: folks_favourite_details_change_is_favourite_finish()

Since 0.6.2

folks_favourite_details_change_is_favourite_finish ()

void
folks_favourite_details_change_is_favourite_finish
                               (FolksFavouriteDetails *self,
                                GAsyncResult *_res_,
                                GError **error);

Change whether the contact is a user-defined favourite.

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

FolksPropertyError will be returned in error

if setting the favouriteness failed

See also: folks_favourite_details_change_is_favourite()

Since 0.6.2

folks_favourite_details_get_is_favourite ()

gboolean
folks_favourite_details_get_is_favourite
                               (FolksFavouriteDetails *self);

Get and return the current value of the "is-favourite" property.

Whether this contact is a user-defined favourite.

folks_favourite_details_set_is_favourite ()

void
folks_favourite_details_set_is_favourite
                               (FolksFavouriteDetails *self,
                                gboolean value);

Set the value of the "is-favourite" property to value .

Whether this contact is a user-defined favourite.

FolksFavouriteDetails

typedef struct _FolksFavouriteDetails FolksFavouriteDetails;

Favourite status for a contact.

This allows user-defined favourite contacts to be specified. A contact is a favourite if the user has selected them as such; the semantics of 'favourite' are left unspecified by folks. Typically, a user might select the contacts that they talk to most frequently as their favourite contacts in an instant messaging program, for example.

struct FolksFavouriteDetailsIface

struct FolksFavouriteDetailsIface {
	GTypeInterface parent_iface;
	void (*change_is_favourite) (FolksFavouriteDetails* self, gboolean is_favourite, GAsyncReadyCallback _callback_, gpointer _user_data_);
	void (*change_is_favourite_finish) (FolksFavouriteDetails* self, GAsyncResult* _res_, GError** error);
	gboolean (*get_is_favourite) (FolksFavouriteDetails* self);
	void (*set_is_favourite) (FolksFavouriteDetails* self, gboolean value);
};

Interface for creating FolksFavouriteDetails implementations.

The “is-favourite” property

  “is-favourite”             gboolean

Whether this contact is a user-defined favourite.

Flags: Read / Write

Default value: FALSE