Top |
FolksEmailFieldDetailsFolksEmailFieldDetails — Object representing a email address that can have some parameters associated with it. |
struct | FolksEmailFieldDetails |
struct | FolksEmailFieldDetailsClass |
FolksEmailDetails | |
struct | FolksEmailDetailsIface |
GInterface ╰── FolksEmailDetails GObject ╰── FolksAbstractFieldDetails ╰── FolksEmailFieldDetails
#define FOLKS_TYPE_EMAIL_FIELD_DETAILS (folks_email_field_details_get_type ())
The type for FolksEmailFieldDetails.
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_ |
||
error |
location to store the error occuring, 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
struct FolksEmailFieldDetails;
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.
GTypeInterface |
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" |
“email-addresses”
property “email-addresses” GeeSet *
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
>”).
Flags: Read / Write
Since 0.6.0