folks_alias_details_change_alias ()

void
folks_alias_details_change_alias (FolksAliasDetails *self,
                                  const gchar *alias,
                                  GAsyncReadyCallback _callback_,
                                  gpointer _user_data_);

Change the contact's alias.

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

FolksPropertyError will be returned in error

if setting the alias failed

See also: folks_alias_details_change_alias_finish()

Since 0.6.2

folks_alias_details_change_alias_finish ()

void
folks_alias_details_change_alias_finish
                               (FolksAliasDetails *self,
                                GAsyncResult *_res_,
                                GError **error);

Change the contact's alias.

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

FolksPropertyError will be returned in error

if setting the alias failed

See also: folks_alias_details_change_alias()

Since 0.6.2

folks_alias_details_get_alias ()

const gchar *
folks_alias_details_get_alias (FolksAliasDetails *self);

Get and return the current value of the "alias" property.

An alias for the contact.

An alias is a user-given name, to be used in UIs as the sole way to represent the contact to the user.

This may not be null: an empty string represents an unset alias.

folks_alias_details_set_alias ()

void
folks_alias_details_set_alias (FolksAliasDetails *self,
                               const gchar *value);

Set the value of the "alias" property to value .

An alias for the contact.

An alias is a user-given name, to be used in UIs as the sole way to represent the contact to the user.

This may not be null: an empty string represents an unset alias.

FolksAliasDetails

typedef struct _FolksAliasDetails FolksAliasDetails;

Alias for a contact.

This allows representation of aliases for contacts, where the user has chosen their own name for the contact to better represent that contact to them. A typical example of this is the use of user-chosen aliases for contacts in instant messaging programs.

struct FolksAliasDetailsIface

struct FolksAliasDetailsIface {
	GTypeInterface parent_iface;
	void (*change_alias) (FolksAliasDetails* self, const gchar* alias, GAsyncReadyCallback _callback_, gpointer _user_data_);
	void (*change_alias_finish) (FolksAliasDetails* self, GAsyncResult* _res_, GError** error);
	const gchar* (*get_alias) (FolksAliasDetails* self);
	void (*set_alias) (FolksAliasDetails* self, const gchar* value);
};

Interface for creating FolksAliasDetails implementations.

The “alias” property

  “alias”                    gchar *

An alias for the contact.

An alias is a user-given name, to be used in UIs as the sole way to represent the contact to the user.

This may not be null: an empty string represents an unset alias.

Flags: Read / Write

Default value: NULL