| Top |
FolksEmailFieldDetailsFolksEmailFieldDetails — Object representing a email address that can have some parameters associated with it. |
| #define | FOLKS_TYPE_EMAIL_FIELD_DETAILS |
| struct | FolksEmailFieldDetails |
| struct | FolksEmailFieldDetailsClass |
| FolksEmailDetails | |
| struct | FolksEmailDetailsIface |
FolksEmailFieldDetails * folks_email_field_details_new (const gchar *value,GeeMultiMap *parameters);
Create a new EmailFieldDetails.
value |
. the value of the field, which should be a valid, non-empty e-mail address . |
[in] |
parameters |
. initial parameters. See "parameters". A . |
[in][allow-none] |
Since: 0.6.0
void folks_email_details_change_email_addresses (FolksEmailDetails *self,GeeSet *email_addresses,GAsyncReadyCallback _callback_,gpointer _user_data_);
Change the contact's set of e-mail addresses.
It's preferred to call this rather than setting "email-addresses" directly, as this method gives error notification and will only return once the e-mail addresses have been written to the relevant backing store (or the operation's failed).
FolksPropertyError will be returned in error
if setting the e-mail addresses failed
See also: folks_email_details_change_email_addresses_finish()
self |
the FolksEmailDetails instance |
|
email_addresses |
. the new set of e-mail addresses . |
[in] |
_callback_ |
callback to call when the request is satisfied. |
[scope async] |
_user_data_ |
the data to pass to |
[closure] |
Since: 0.6.2
void folks_email_details_change_email_addresses_finish (FolksEmailDetails *self,GAsyncResult *_res_,GError **error);
Change the contact's set of e-mail addresses.
It's preferred to call this rather than setting "email-addresses" directly, as this method gives error notification and will only return once the e-mail addresses have been written to the relevant backing store (or the operation's failed).
FolksPropertyError will be returned in error
if setting the e-mail addresses failed
See also: folks_email_details_change_email_addresses()
self |
the FolksEmailDetails instance |
|
_res_ |
a GAsyncResult |
|
error |
location to store the error occurring, or |
[error-domains FolksPropertyError] |
Since: 0.6.2
GeeSet *
folks_email_details_get_email_addresses
(FolksEmailDetails *self);
Get and return the current value of the "email-addresses" property.
The email addresses of the contact.
Each of the values in this property contains just an e-mail address (e.g. “foobar.com”), rather than any other way of formatting an e-mail address (such as “John Smith <foobar.com>”).
Since: 0.6.0
void folks_email_details_set_email_addresses (FolksEmailDetails *self,GeeSet *value);
Set the value of the "email-addresses" property to value
.
The email addresses of the contact.
Each of the values in this property contains just an e-mail address (e.g. “foobar.com”), rather than any other way of formatting an e-mail address (such as “John Smith <foobar.com>”).
self |
the FolksEmailDetails instance to modify |
|
value |
the new value of the "email-addresses" property |
Since: 0.6.0
#define FOLKS_TYPE_EMAIL_FIELD_DETAILS (folks_email_field_details_get_type ())
The type for FolksEmailFieldDetails.
struct FolksEmailFieldDetails {
FolksAbstractFieldDetails parent_instance;
FolksEmailFieldDetailsPrivate * priv;
};
Object representing a email address that can have some parameters associated with it.
See FolksAbstractFieldDetails for details on common parameter names and values.
Since: 0.6.0
struct FolksEmailFieldDetailsClass {
FolksAbstractFieldDetailsClass parent_class;
};
The class structure for FOLKS_TYPE_EMAIL_FIELD_DETAILS. All the fields in this structure are private and should never be accessed directly.
typedef struct _FolksEmailDetails FolksEmailDetails;
Interface for classes that have email addresses, such as FolksPersona and FolksIndividual.
Since: 0.3.5
struct FolksEmailDetailsIface {
GTypeInterface parent_iface;
void (*change_email_addresses) (FolksEmailDetails* self, GeeSet* email_addresses, GAsyncReadyCallback _callback_, gpointer _user_data_);
void (*change_email_addresses_finish) (FolksEmailDetails* self, GAsyncResult* _res_, GError** error);
GeeSet* (*get_email_addresses) (FolksEmailDetails* self);
void (*set_email_addresses) (FolksEmailDetails* self, GeeSet* value);
};
Interface for creating FolksEmailDetails implementations.
the parent interface structure |
||
virtual method called by |
||
asynchronous finish function for |
||
getter method for the abstract property "email-addresses" |
||
setter method for the abstract property "email-addresses" |