Top |
FolksExtendedFieldDetailsFolksExtendedFieldDetails — Object representing an arbitrary field that can have some parameters associated with it. This is intended to be as general-purpose as, for example, a vCard property. See the documentation for FolksExtendedInfo for information on when using this object is appropriate. |
#define | FOLKS_TYPE_EXTENDED_FIELD_DETAILS |
struct | FolksExtendedFieldDetails |
struct | FolksExtendedFieldDetailsClass |
FolksExtendedInfo | |
struct | FolksExtendedInfoIface |
#define FOLKS_TYPE_EXTENDED_FIELD_DETAILS (folks_extended_field_details_get_type ())
The type for FolksExtendedFieldDetails.
struct FolksExtendedFieldDetails { FolksAbstractFieldDetails parent_instance; FolksExtendedFieldDetailsPrivate * priv; };
Object representing an arbitrary field that can have some parameters associated with it. This is intended to be as general-purpose as, for example, a vCard property. See the documentation for FolksExtendedInfo for information on when using this object is appropriate.
See FolksAbstractFieldDetails for details on common parameter names and values.
Since: 0.11.0
struct FolksExtendedFieldDetailsClass { FolksAbstractFieldDetailsClass parent_class; };
The class structure for FOLKS_TYPE_EXTENDED_FIELD_DETAILS
. All the fields in this structure are private and should never be accessed directly.
typedef struct _FolksExtendedInfo FolksExtendedInfo;
Arbitrary field interface.
This interface allows clients to store arbitrary fields for contacts in backends that support it.
This interface should be used for application-specific data, in which case the application should use the vCard approach to prefixing non-standard property names: `X-[APPLICATION NAME]-*’. Note that this is a global namespace, shared between all consumers of the backend’s data, so please namespace application-specific data with the application’s name.
This interface should not be used for more general-purpose data which could be better represented with a type-safe interface implemented in libfolks. It must not be used for data which is already represented with a type-safe interface in libfolks.
A good example of data which could be stored on this interface is an e-mail application’s setting of whether a content prefers to receive HTML or plaintext e-mail.
A good example of data which should not be stored on this interface is a contact’s anniversary. That should be added in a separate interface in libfolks.
Since: 0.11.0
struct FolksExtendedInfoIface { GTypeInterface parent_iface; FolksExtendedFieldDetails* (*get_extended_field) (FolksExtendedInfo* self, const gchar* name); void (*change_extended_field) (FolksExtendedInfo* self, const gchar* name, FolksExtendedFieldDetails* value, GAsyncReadyCallback _callback_, gpointer _user_data_); void (*change_extended_field_finish) (FolksExtendedInfo* self, GAsyncResult* _res_, GError** error); void (*remove_extended_field) (FolksExtendedInfo* self, const gchar* name, GAsyncReadyCallback _callback_, gpointer _user_data_); void (*remove_extended_field_finish) (FolksExtendedInfo* self, GAsyncResult* _res_, GError** error); };
Interface for creating FolksExtendedInfo implementations.
the parent interface structure |
||
virtual method called by |
||
virtual method called by |
||
asynchronous finish function for |
||
virtual method called by |
||
asynchronous finish function for |