OssoABookRecentGroup

OssoABookRecentGroup — A smart group for recently used contacts.

Synopsis

                    OssoABookRecentGroup;
OssoABookGroup*     osso_abook_recent_group_get         (void);
void                osso_abook_recent_group_set_roster  (OssoABookRecentGroup *group,
                                                         OssoABookRoster *roster);
OssoABookRoster*    osso_abook_recent_group_get_roster  (OssoABookRecentGroup *group);

Description

This group contains the most recently used contacts.

Details

OssoABookRecentGroup

typedef struct {
} OssoABookRecentGroup;

All the fields of this structure are private to the object's implementation and should never be accessed directly.


osso_abook_recent_group_get ()

OssoABookGroup*     osso_abook_recent_group_get         (void);

Retrieves the recently used contacts group. Note that this function is not thread-safe. Also note that for any contacts to show up, the newly created group should be bound to an OssoABookRoster using osso_abook_recent_group_set_book_view().

Returns : The OssoABookRecentGroup. This is a singleton; don't g_object_unref() it.

osso_abook_recent_group_set_roster ()

void                osso_abook_recent_group_set_roster  (OssoABookRecentGroup *group,
                                                         OssoABookRoster *roster);

On first call sets the OssoABookRoster that is to be monitored for recently used contacts. Any subsequent calls are ignored.

group : An OssoABookRecentGroup
roster : The OssoABookRoster to be monitored

osso_abook_recent_group_get_roster ()

OssoABookRoster*    osso_abook_recent_group_get_roster  (OssoABookRecentGroup *group);

Retrieves the monitored OssoABookRoster.

group : An OssoABookRecentGroup
Returns : The monitored OssoABookRoster.