X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=gtk%2Fgtktreesortable.c;h=1987d77972894ea7649be46417ff15c57553ad4b;hb=10862a344aa8fb44e6045343ddf65eb0d14cc1b2;hp=b2833af60eb18174ce5970e9ac025514c87a6154;hpb=21fd434c5f528546a35036b4cfce6a708a4c2762;p=~andy%2Fgtk diff --git a/gtk/gtktreesortable.c b/gtk/gtktreesortable.c index b2833af60..1987d7797 100644 --- a/gtk/gtktreesortable.c +++ b/gtk/gtktreesortable.c @@ -18,19 +18,22 @@ */ +#include #include "gtktreesortable.h" -#include "gtksignal.h" +#include "gtkmarshalers.h" +#include "gtkintl.h" +#include "gtkalias.h" static void gtk_tree_sortable_base_init (gpointer g_class); -GtkType +GType gtk_tree_sortable_get_type (void) { - static GtkType tree_sortable_type = 0; + static GType tree_sortable_type = 0; if (! tree_sortable_type) { - static const GTypeInfo tree_sortable_info = + const GTypeInfo tree_sortable_info = { sizeof (GtkTreeSortableIface), /* class_size */ gtk_tree_sortable_base_init, /* base_init */ @@ -42,8 +45,12 @@ gtk_tree_sortable_get_type (void) 0, NULL }; - tree_sortable_type = g_type_register_static (G_TYPE_INTERFACE, "GtkTreeSortable", &tree_sortable_info, 0); - g_type_interface_add_prerequisite (tree_sortable_type, G_TYPE_OBJECT); + + tree_sortable_type = + g_type_register_static (G_TYPE_INTERFACE, I_("GtkTreeSortable"), + &tree_sortable_info, 0); + + g_type_interface_add_prerequisite (tree_sortable_type, GTK_TYPE_TREE_MODEL); } return tree_sortable_type; @@ -56,25 +63,52 @@ gtk_tree_sortable_base_init (gpointer g_class) if (! initialized) { - g_signal_newc ("sort_column_changed", - GTK_TYPE_TREE_SORTABLE, - G_SIGNAL_RUN_LAST, - G_STRUCT_OFFSET (GtkTreeSortableIface, sort_column_changed), - NULL, NULL, - gtk_marshal_VOID__VOID, - G_TYPE_NONE, 0); + g_signal_new (I_("sort_column_changed"), + GTK_TYPE_TREE_SORTABLE, + G_SIGNAL_RUN_LAST, + G_STRUCT_OFFSET (GtkTreeSortableIface, sort_column_changed), + NULL, NULL, + _gtk_marshal_VOID__VOID, + G_TYPE_NONE, 0); initialized = TRUE; } } +/** + * gtk_tree_sortable_sort_column_changed: + * @sortable: A #GtkTreeSortable + * + * Emits a GtkTreeSortable::sort_column_changed signal on + **/ +void +gtk_tree_sortable_sort_column_changed (GtkTreeSortable *sortable) +{ + g_return_if_fail (GTK_IS_TREE_SORTABLE (sortable)); + + g_signal_emit_by_name (sortable, "sort_column_changed"); +} + +/** + * gtk_tree_sortable_get_sort_column_id: + * @sortable: A #GtkTreeSortable + * @sort_column_id: The sort column id to be filled in + * @order: The #GtkSortType to be filled in + * + * Fills in @sort_column_id and @order with the current sort column and the + * order. It returns %TRUE unless the @sort_column_id is + * %GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID or + * %GTK_TREE_SORTABLE_UNSORTED_SORT_COLUMN_ID. + * + * Return value: %TRUE if the sort column is not one of the special sort + * column ids. + **/ gboolean gtk_tree_sortable_get_sort_column_id (GtkTreeSortable *sortable, gint *sort_column_id, - GtkTreeSortOrder *order) + GtkSortType *order) { GtkTreeSortableIface *iface; - g_return_val_if_fail (sortable != NULL, FALSE); g_return_val_if_fail (GTK_IS_TREE_SORTABLE (sortable), FALSE); iface = GTK_TREE_SORTABLE_GET_IFACE (sortable); @@ -85,14 +119,25 @@ gtk_tree_sortable_get_sort_column_id (GtkTreeSortable *sortable, return (* iface->get_sort_column_id) (sortable, sort_column_id, order); } +/** + * gtk_tree_sortable_set_sort_column_id: + * @sortable: A #GtkTreeSortable + * @sort_column_id: the sort column id to set + * @order: The sort order of the column + * + * Sets the current sort column to be @sort_column_id. The @sortable will + * resort itself to reflect this change, after emitting a + * GtkTreeSortable::sort_column_changed signal. If @sort_column_id is + * %GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID, then the default sort function + * will be used, if it is set. + **/ void gtk_tree_sortable_set_sort_column_id (GtkTreeSortable *sortable, gint sort_column_id, - GtkTreeSortOrder order) + GtkSortType order) { GtkTreeSortableIface *iface; - g_return_if_fail (sortable != NULL); g_return_if_fail (GTK_IS_TREE_SORTABLE (sortable)); iface = GTK_TREE_SORTABLE_GET_IFACE (sortable); @@ -101,27 +146,100 @@ gtk_tree_sortable_set_sort_column_id (GtkTreeSortable *sortable, g_return_if_fail (iface->set_sort_column_id != NULL); (* iface->set_sort_column_id) (sortable, sort_column_id, order); +} + +/** + * gtk_tree_sortable_set_sort_func: + * @sortable: A #GtkTreeSortable + * @sort_column_id: the sort column id to set the function for + * @sort_func: The comparison function + * @user_data: User data to pass to @sort_func, or %NULL + * @destroy: Destroy notifier of @user_data, or %NULL + * + * Sets the comparison function used when sorting to be @sort_func. If the + * current sort column id of @sortable is the same as @sort_column_id, then the + * model will sort using this function. + **/ +void +gtk_tree_sortable_set_sort_func (GtkTreeSortable *sortable, + gint sort_column_id, + GtkTreeIterCompareFunc sort_func, + gpointer user_data, + GtkDestroyNotify destroy) +{ + GtkTreeSortableIface *iface; + + g_return_if_fail (GTK_IS_TREE_SORTABLE (sortable)); + g_return_if_fail (sort_func != NULL); + iface = GTK_TREE_SORTABLE_GET_IFACE (sortable); + + g_return_if_fail (iface != NULL); + g_return_if_fail (iface->set_sort_func != NULL); + g_return_if_fail (sort_column_id >= 0); + + (* iface->set_sort_func) (sortable, sort_column_id, sort_func, user_data, destroy); } +/** + * gtk_tree_sortable_set_default_sort_func: + * @sortable: A #GtkTreeSortable + * @sort_func: The comparison function + * @user_data: User data to pass to @sort_func, or %NULL + * @destroy: Destroy notifier of @user_data, or %NULL + * + * Sets the default comparison function used when sorting to be @sort_func. + * If the current sort column id of @sortable is + * %GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID, then the model will sort using + * this function. + * + * If @sort_func is %NULL, then there will be no default comparison function. + * This means that once the model has been sorted, it can't go back to the + * default state. In this case, when the current sort column id of @sortable is + * GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID, the model will be unsorted. + **/ void -gtk_tree_sortable_sort_column_id_set_func (GtkTreeSortable *sortable, - gint sort_column_id, - GtkTreeIterCompareFunc func, - gpointer data, - GtkDestroyNotify destroy) +gtk_tree_sortable_set_default_sort_func (GtkTreeSortable *sortable, + GtkTreeIterCompareFunc sort_func, + gpointer user_data, + GtkDestroyNotify destroy) { GtkTreeSortableIface *iface; - g_return_if_fail (sortable != NULL); g_return_if_fail (GTK_IS_TREE_SORTABLE (sortable)); iface = GTK_TREE_SORTABLE_GET_IFACE (sortable); g_return_if_fail (iface != NULL); - g_return_if_fail (iface->sort_column_id_set_func != NULL); + g_return_if_fail (iface->set_default_sort_func != NULL); - (* iface->sort_column_id_set_func) (sortable, sort_column_id, func, data, destroy); + (* iface->set_default_sort_func) (sortable, sort_func, user_data, destroy); } +/** + * gtk_tree_sortable_has_default_sort_func: + * @sortable: A #GtkTreeSortable + * + * Returns %TRUE if the model has a default sort function. This is used + * primarily by GtkTreeViewColumns in order to determine if a model can go back + * to the default state, or not. + * + * Return value: %TRUE, if the model has a default sort function + **/ +gboolean +gtk_tree_sortable_has_default_sort_func (GtkTreeSortable *sortable) +{ + GtkTreeSortableIface *iface; + + g_return_val_if_fail (GTK_IS_TREE_SORTABLE (sortable), FALSE); + + iface = GTK_TREE_SORTABLE_GET_IFACE (sortable); + + g_return_val_if_fail (iface != NULL, FALSE); + g_return_val_if_fail (iface->has_default_sort_func != NULL, FALSE); + + return (* iface->has_default_sort_func) (sortable); +} +#define __GTK_TREE_SORTABLE_C__ +#include "gtkaliasdef.c"