*/
+#include <config.h>
#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 */
0,
NULL
};
- tree_sortable_type = g_type_register_static (G_TYPE_INTERFACE, "GtkTreeSortable", &tree_sortable_info, 0);
+
+ 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);
}
if (! initialized)
{
- g_signal_new ("sort_column_changed",
+ 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,
+ _gtk_marshal_VOID__VOID,
G_TYPE_NONE, 0);
initialized = TRUE;
}
{
g_return_if_fail (GTK_IS_TREE_SORTABLE (sortable));
- g_signal_emit_by_name (G_OBJECT (sortable),
- "sort_column_changed");
+ g_signal_emit_by_name (sortable, "sort_column_changed");
}
/**
* @order: The #GtkSortType to be filled in
*
* Fills in @sort_column_id and @order with the current sort column and the
- * order, if applicable. If the sort column is not set, then FALSE is returned,
- * and the values in @sort_column_id and @order are unchanged.
- *
- * Return value: %TRUE, if the sort column has been set
+ * 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,
*
* 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 -1, then
- * the default sort function will be used, if it is set.
+ * 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,
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 sorting function
- * @user_data: User data to pass to the sort func, or %NULL
+ * @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.
+ * model will sort using this function.
**/
void
gtk_tree_sortable_set_sort_func (GtkTreeSortable *sortable,
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 sorting function
- * @user_data: User data to pass to the sort func, or %NULL
+ * @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 the same as @sort_column_id, then
- * the model will sort.
+ * 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_set_default_sort_func (GtkTreeSortable *sortable,
{
GtkTreeSortableIface *iface;
- g_return_if_fail (GTK_IS_TREE_SORTABLE (sortable));
+ g_return_val_if_fail (GTK_IS_TREE_SORTABLE (sortable), FALSE);
iface = GTK_TREE_SORTABLE_GET_IFACE (sortable);
- g_return_if_fail (iface != NULL);
- g_return_if_fail (iface->has_default_sort_func != NULL);
+ g_return_val_if_fail (iface != NULL, FALSE);
+ g_return_val_if_fail (iface->has_default_sort_func != NULL, FALSE);
- (* iface->has_default_sort_func) (sortable);
+ return (* iface->has_default_sort_func) (sortable);
}
+
+#define __GTK_TREE_SORTABLE_C__
+#include "gtkaliasdef.c"