Osso Addressbook Reference Manual | ||||
---|---|---|---|---|
OssoABookGroup; const char* osso_abook_group_get_name (OssoABookGroup *group); const char* osso_abook_group_get_display_name (OssoABookGroup *group); const char* osso_abook_group_get_display_title (OssoABookGroup *group); const char* osso_abook_group_get_icon_name (OssoABookGroup *group); GtkWidget* osso_abook_group_get_empty_widget (OssoABookGroup *group); gboolean osso_abook_group_is_visible (OssoABookGroup *group); gboolean osso_abook_group_includes_contact (OssoABookGroup *group, OssoABookContact *contact); int osso_abook_group_get_sort_weight (OssoABookGroup *group); gboolean osso_abook_group_get_sensitive (OssoABookGroup *group); OssoABookListStoreCompareFunc osso_abook_group_get_sort_func (OssoABookGroup *group); int osso_abook_group_compare (OssoABookGroup *a, OssoABookGroup *b); OssoABookListStore* osso_abook_group_get_model (OssoABookGroup *group);
GObject +----OssoABookGroup +----OssoABookAllGroup +----OssoABookServiceGroup +----OssoABookRecentGroup +----OssoABookProfileGroup
"display-title" gchar* : Read "icon-name" gchar* : Read / Write "name" gchar* : Read / Write / Construct Only "sensitive" gboolean : Read / Write "sort-weight" gint : Read / Write "visible" gboolean : Read / Write
typedef struct _OssoABookGroup OssoABookGroup;
All the fields of this structure are private to the object's implementation and should never be accessed directly.
const char* osso_abook_group_get_name (OssoABookGroup *group);
Retrieves the name of group
. Use osso_abook_group_get_display_name()
to get the translated name for display.
group : |
an OssoABookGroup |
Returns : | The name of group . This string is owned by libosso-abook
and should not be freed.
|
const char* osso_abook_group_get_display_name (OssoABookGroup *group);
Retrieves the name of group
, translated for the current locale.
group : |
an OssoABookGroup |
Returns : | The translated name of group . This string is owned by
libosso-abook and should not be freed.
|
const char* osso_abook_group_get_display_title (OssoABookGroup *group);
Retrieves the window title for group
, translated for the current locale.
group : |
an OssoABookGroup |
Returns : | The translated display title of group . This string is owned by
libosso-abook and should not be freed.
|
const char* osso_abook_group_get_icon_name (OssoABookGroup *group);
Retrieves the icon name associated with group
. The icon name can be
used to look up the appropiate icon to represent group
.
group : |
an OssoABookGroup |
Returns : | The icon name associated with group . This string is owned
by libosso-abook and should not be freed.
|
GtkWidget* osso_abook_group_get_empty_widget (OssoABookGroup *group);
Retrieves the widget to display when group
is empty.
group : |
an OssoABookGroup |
Returns : | The empty widget of group .
|
gboolean osso_abook_group_is_visible (OssoABookGroup *group);
Returns a boolean indicating whether group
is requested to be shown
or not.
group : |
an OssoABookGroup |
Returns : | TRUE if group is requested to be shown, FALSE otherwise.
|
gboolean osso_abook_group_includes_contact (OssoABookGroup *group, OssoABookContact *contact);
Returns a boolean indicating whether this contact
is included in group
.
group : |
an OssoABookGroup |
contact : |
an OssoABookContact whose inclusion is to be checked |
Returns : | TRUE if this contact is included in group , FALSE otherwise.
|
int osso_abook_group_get_sort_weight (OssoABookGroup *group);
Returns the sort weight of group
. Groups are sorted by first comparing
the sort weights, and then collating the names. A lower sort weight
indicates a higher sorting priority.
group : |
an OssoABookGroup |
Returns : | An integer indicating the sort weight of group .
|
gboolean osso_abook_group_get_sensitive (OssoABookGroup *group);
Returns the sensitivity of group
.
group : |
an OssoABookGroup |
Returns : | TRUE if the group is sensitive, FALSE if not. |
OssoABookListStoreCompareFunc osso_abook_group_get_sort_func (OssoABookGroup *group);
Returns a function the can be used to sort the OssoABookListStore that
displays group
. See also osso_abook_list_store_set_sort_key()
.
group : |
an OssoABookGroup |
Returns : | an GtkTreeIterCompareFunc or NULL |
int osso_abook_group_compare (OssoABookGroup *a, OssoABookGroup *b);
Compares group a
to group b
, first comparing the sort weights, and then
collating the names. A lower sort weight indicates a higher sorting
priority.
a : |
an OssoABookGroup |
b : |
an OssoABookGroup |
Returns : | < 0 if group a compares before group b , 0 if they compare
equal, > 0 if group a compares after group b .
|
OssoABookListStore* osso_abook_group_get_model (OssoABookGroup *group);
Retrieves the OssoABookListStore storing the contacts of this group.
group : |
a OssoABookGroup |
Returns : | A OssoABookListStore instance. |
"display-title"
property"display-title" gchar* : Read
The display title of the group.
Default value: NULL
"icon-name"
property"icon-name" gchar* : Read / Write
The icon name of the group. The icon name can be used to look up the appropiate icon to represent the group.
Default value: NULL
"name"
property"name" gchar* : Read / Write / Construct Only
The name of the group.
Default value: NULL
"sensitive"
property"sensitive" gboolean : Read / Write
Whether the group is sensitive.
Default value: TRUE
"sort-weight"
property"sort-weight" gint : Read / Write
Sort weight of the group. A lower value results in a higher sorting priority.
Default value: 0
"refilter-contact"
signalvoid user_function (OssoABookGroup *group, OssoABookContact *contact, gpointer user_data) : Run Last
This signal is emitted when a contact was changed and the group has to be filtered again.
group : |
a OssoABookGroup |
contact : |
the changed OssoABookContact |
user_data : |
user data set when the signal handler was connected. |
"refilter-group"
signalvoid user_function (OssoABookGroup *group, gpointer user_data) : Run Last
This signal is emitted when the group was modified and has to be filtered again.
group : |
a OssoABookGroup |
user_data : |
user data set when the signal handler was connected. |