FolksBirthdayDetails

FolksBirthdayDetails — This interface contains the birth date of a FolksPersona and FolksIndividual

Synopsis

void                folks_birthday_details_change_birthday
                                                        (FolksBirthdayDetails *self,
                                                         GDateTime *birthday,
                                                         GAsyncReadyCallback _callback_,
                                                         gpointer _user_data_);
void                folks_birthday_details_change_birthday_finish
                                                        (FolksBirthdayDetails *self,
                                                         GAsyncResult *_res_,
                                                         GError **error);
void                folks_birthday_details_change_calendar_event_id
                                                        (FolksBirthdayDetails *self,
                                                         const gchar *event_id,
                                                         GAsyncReadyCallback _callback_,
                                                         gpointer _user_data_);
void                folks_birthday_details_change_calendar_event_id_finish
                                                        (FolksBirthdayDetails *self,
                                                         GAsyncResult *_res_,
                                                         GError **error);
GDateTime *         folks_birthday_details_get_birthday (FolksBirthdayDetails *self);
void                folks_birthday_details_set_birthday (FolksBirthdayDetails *self,
                                                         GDateTime *value);
const gchar *       folks_birthday_details_get_calendar_event_id
                                                        (FolksBirthdayDetails *self);
void                folks_birthday_details_set_calendar_event_id
                                                        (FolksBirthdayDetails *self,
                                                         const gchar *value);
                    FolksBirthdayDetails;

Object Hierarchy

  GInterface
   +----FolksBirthdayDetails

Prerequisites

FolksBirthdayDetails requires GObject.

Known Implementations

FolksBirthdayDetails is implemented by FolksIndividual.

Properties

  "birthday"                 GDateTime*            : Read / Write
  "calendar-event-id"        gchar*                : Read / Write

Description

Details

folks_birthday_details_change_birthday ()

void                folks_birthday_details_change_birthday
                                                        (FolksBirthdayDetails *self,
                                                         GDateTime *birthday,
                                                         GAsyncReadyCallback _callback_,
                                                         gpointer _user_data_);

Change the contact's birthday.

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

See also: folks_birthday_details_change_birthday_finish()

self :

the FolksBirthdayDetails instance

birthday :

the new birthday (or `null` to unset the birthday). [in][allow-none]

_callback_ :

callback to call when the request is satisfied. [scope async]

_user_data_ :

the data to pass to _callback_ function. [closure]

Since 0.6.2


folks_birthday_details_change_birthday_finish ()

void                folks_birthday_details_change_birthday_finish
                                                        (FolksBirthdayDetails *self,
                                                         GAsyncResult *_res_,
                                                         GError **error);

Change the contact's birthday.

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

See also: folks_birthday_details_change_birthday()

self :

the FolksBirthdayDetails instance

_res_ :

a GAsyncResult

error :

location to store the error occuring, or NULL to ignore. [error-domains FolksPropertyError]

Since 0.6.2


folks_birthday_details_change_calendar_event_id ()

void                folks_birthday_details_change_calendar_event_id
                                                        (FolksBirthdayDetails *self,
                                                         const gchar *event_id,
                                                         GAsyncReadyCallback _callback_,
                                                         gpointer _user_data_);

Change the contact's birthday event ID.

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

See also: folks_birthday_details_change_calendar_event_id_finish()

self :

the FolksBirthdayDetails instance

event_id :

the new birthday event ID (or `null` to unset the event ID). [in][allow-none]

_callback_ :

callback to call when the request is satisfied. [scope async]

_user_data_ :

the data to pass to _callback_ function. [closure]

Since 0.6.2


folks_birthday_details_change_calendar_event_id_finish ()

void                folks_birthday_details_change_calendar_event_id_finish
                                                        (FolksBirthdayDetails *self,
                                                         GAsyncResult *_res_,
                                                         GError **error);

Change the contact's birthday event ID.

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

See also: folks_birthday_details_change_calendar_event_id()

self :

the FolksBirthdayDetails instance

_res_ :

a GAsyncResult

error :

location to store the error occuring, or NULL to ignore. [error-domains FolksPropertyError]

Since 0.6.2


folks_birthday_details_get_birthday ()

GDateTime *         folks_birthday_details_get_birthday (FolksBirthdayDetails *self);

self :

the FolksBirthdayDetails instance to query

Returns :

the value of the "birthday" property

folks_birthday_details_set_birthday ()

void                folks_birthday_details_set_birthday (FolksBirthdayDetails *self,
                                                         GDateTime *value);

self :

the FolksBirthdayDetails instance to modify

value :

the new value of the "birthday" property

folks_birthday_details_get_calendar_event_id ()

const gchar *       folks_birthday_details_get_calendar_event_id
                                                        (FolksBirthdayDetails *self);

self :

the FolksBirthdayDetails instance to query

Returns :

the value of the "calendar-event-id" property

folks_birthday_details_set_calendar_event_id ()

void                folks_birthday_details_set_calendar_event_id
                                                        (FolksBirthdayDetails *self,
                                                         const gchar *value);

self :

the FolksBirthdayDetails instance to modify

value :

the new value of the "calendar-event-id" property

FolksBirthdayDetails

typedef struct _FolksBirthdayDetails FolksBirthdayDetails;

This interface contains the birth date of a FolksPersona and FolksIndividual

Since 0.4.0

Property Details

The "birthday" property

  "birthday"                 GDateTime*            : Read / Write

The birthday of the FolksPersona and FolksIndividual. This is assumed to be in UTC.

If this is `null`, the contact's birthday isn't known.

Since 0.4.0


The "calendar-event-id" property

  "calendar-event-id"        gchar*                : Read / Write

The event ID of the birthday event from the source calendar.

If this is `null`, the birthday event is unknown.

Default value: NULL

Since 0.4.0