Top |
FolksPhoneFieldDetailsFolksPhoneFieldDetails — Object representing a phone number that can have some parameters associated with it. |
struct | FolksPhoneFieldDetails |
struct | FolksPhoneFieldDetailsClass |
FolksPhoneDetails | |
struct | FolksPhoneDetailsIface |
GInterface ╰── FolksPhoneDetails GObject ╰── FolksAbstractFieldDetails ╰── FolksPhoneFieldDetails
#define FOLKS_TYPE_PHONE_FIELD_DETAILS (folks_phone_field_details_get_type ())
The type for FolksPhoneFieldDetails.
gchar *
folks_phone_field_details_get_normalised
(FolksPhoneFieldDetails *self
);
Return this object's normalised phone number.
Typical normalisations:
- 1-800-123-4567
→ 18001234567
- +1-800-123-4567
→ +18001234567
- +1-800-123-4567P123
→ +18001234567P123
Since 0.6.0
FolksPhoneFieldDetails * folks_phone_field_details_new (const gchar *value
,GeeMultiMap *parameters
);
Create a new PhoneFieldDetails.
value |
. the value of the field, which should be a non-empty phone number (no particular format is mandated) . |
[in] |
parameters |
. initial parameters. See "parameters". A . |
[in][allow-none] |
Since 0.6.0
void folks_phone_details_change_phone_numbers (FolksPhoneDetails *self
,GeeSet *phone_numbers
,GAsyncReadyCallback _callback_
,gpointer _user_data_
);
Change the contact's phone numbers.
It's preferred to call this rather than setting "phone-numbers" directly, as this method gives error notification and will only return once the phone numbers have been written to the relevant backing store (or the operation's failed).
FolksPropertyError will be returned in error
if setting the phone numbers failed
See also: folks_phone_details_change_phone_numbers_finish()
self |
the FolksPhoneDetails instance |
|
phone_numbers |
. the set of phone numbers . |
[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_phone_details_change_phone_numbers_finish (FolksPhoneDetails *self
,GAsyncResult *_res_
,GError **error
);
Change the contact's phone numbers.
It's preferred to call this rather than setting "phone-numbers" directly, as this method gives error notification and will only return once the phone numbers have been written to the relevant backing store (or the operation's failed).
FolksPropertyError will be returned in error
if setting the phone numbers failed
See also: folks_phone_details_change_phone_numbers()
self |
the FolksPhoneDetails instance |
|
_res_ |
||
error |
location to store the error occuring, or |
[error-domains FolksPropertyError] |
Since 0.6.2
GeeSet *
folks_phone_details_get_phone_numbers (FolksPhoneDetails *self
);
Get and return the current value of the "phone-numbers" property.
The phone numbers of the contact.
A list of phone numbers associated to the contact.
Since 0.6.0
void folks_phone_details_set_phone_numbers (FolksPhoneDetails *self
,GeeSet *value
);
Set the value of the "phone-numbers" property to value
.
The phone numbers of the contact.
A list of phone numbers associated to the contact.
self |
the FolksPhoneDetails instance to modify |
|
value |
the new value of the "phone-numbers" property |
Since 0.6.0
struct FolksPhoneFieldDetails;
Object representing a phone number that can have some parameters associated with it.
See FolksAbstractFieldDetails for details on common parameter names and values.
Since 0.6.0
struct FolksPhoneFieldDetailsClass { FolksAbstractFieldDetailsClass parent_class; };
The class structure for FOLKS_TYPE_PHONE_FIELD_DETAILS
. All the fields in this structure are private and should never be accessed directly.
typedef struct _FolksPhoneDetails FolksPhoneDetails;
Interface for classes that can provide a phone number, such as FolksPersona and FolksIndividual.
Since 0.3.5
struct FolksPhoneDetailsIface { GTypeInterface parent_iface; void (*change_phone_numbers) (FolksPhoneDetails* self, GeeSet* phone_numbers, GAsyncReadyCallback _callback_, gpointer _user_data_); void (*change_phone_numbers_finish) (FolksPhoneDetails* self, GAsyncResult* _res_, GError** error); GeeSet* (*get_phone_numbers) (FolksPhoneDetails* self); void (*set_phone_numbers) (FolksPhoneDetails* self, GeeSet* value); };
Interface for creating FolksPhoneDetails implementations.
GTypeInterface |
the parent interface structure |
|
virtual method called by |
||
asynchronous finish function for |
||
getter method for the abstract property "phone-numbers" |
||
setter method for the abstract property "phone-numbers" |