*
* 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);
-
}
/**
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);
}
* @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.
+ * the current sort column id of @sortable is
+ * %GTK_TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID, then the model will sort. If
+ * @sort_func is %NULL, then the default sort_func, and there will be no default
+ * sort_func. In this case, the model is unsorted.
**/
void
gtk_tree_sortable_set_default_sort_func (GtkTreeSortable *sortable,