Gtk.TreeSortable

g GObject.GInterface GObject.GInterface Gtk.TreeSortable Gtk.TreeSortable GObject.GInterface->Gtk.TreeSortable

Implementations:
 Gtk.ListStore, Gtk.TreeModelSort, Gtk.TreeStore

Methods

  get_sort_column_id ()
  has_default_sort_func ()
  set_default_sort_func (sort_func, *user_data)
  set_sort_column_id (sort_column_id, order)
  set_sort_func (sort_column_id, sort_func, *user_data)
  sort_column_changed ()

Virtual Methods

  do_get_sort_column_id ()
  do_has_default_sort_func ()
  do_set_default_sort_func (sort_func, *user_data)
  do_set_sort_column_id (sort_column_id, order)
  do_set_sort_func (sort_column_id, sort_func, *user_data)
  do_sort_column_changed ()

Properties

None

Signals

Name Short Description
sort-column-changed The ::sort-column-changed signal is emitted when the sort column or sort order of sortable is changed.

Fields

None

Class Details

class Gtk.TreeSortable
Bases:GObject.GInterface
Structure:Gtk.TreeSortableIface

Gtk.TreeSortable is an interface to be implemented by tree models which support sorting. The Gtk.TreeView uses the methods provided by this interface to sort the model.

get_sort_column_id()[source]
Returns:(None, None) if the sort column is one of the special sort column ids. Otherwise a tuple containing:
sort_column_id:The sort column id
order:The Gtk.SortType
Return type:(sort_column_id: int, order: Gtk.SortType) or (None, None)

Returns sort_column_id and order with the current sort column and the order. It returns (None, None) if the sort_column_id is Gtk.TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID or Gtk.TREE_SORTABLE_UNSORTED_SORT_COLUMN_ID.

has_default_sort_func()[source]
Returns:True, if the model has a default sort function
Return type:bool

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.

set_default_sort_func(sort_func, *user_data)[source]
Parameters:

Sets the default comparison function used when sorting to be sort_func. If the current sort column id of self is Gtk.TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID, then the model will sort using this function.

If sort_func is None, 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 self is Gtk.TREE_SORTABLE_DEFAULT_SORT_COLUMN_ID, the model will be unsorted.

set_sort_column_id(sort_column_id, order)[source]
Parameters:
  • sort_column_id (int) – the sort column id to set
  • order (Gtk.SortType) – The sort order of the column

Sets the current sort column to be sort_column_id. The self will resort itself to reflect this change, after emitting a Gtk.TreeSortable ::sort-column-changed signal. sort_column_id may either be a regular column id, or one of the following special values:

set_sort_func(sort_column_id, sort_func, *user_data)[source]
Parameters:
  • sort_column_id (int) – the sort column id to set the function for
  • sort_func (Gtk.TreeIterCompareFunc) – The comparison function
  • user_data (object or None) – User data to pass to sort_func, or None

Sets the comparison function used when sorting to be sort_func. If the current sort column id of self is the same as sort_column_id, then the model will sort using this function.

sort_column_changed()[source]

Emits a Gtk.TreeSortable ::sort-column-changed signal on self.

do_get_sort_column_id() virtual
Returns:True if the sort column is not one of the special sort column ids.
sort_column_id:The sort column id to be filled in
order:The Gtk.SortType to be filled in
Return type:(bool, sort_column_id: int, order: Gtk.SortType)

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.

do_has_default_sort_func() virtual
Returns:True, if the model has a default sort function
Return type:bool

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.

do_set_default_sort_func(sort_func, *user_data) virtual
Parameters:

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 None, 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.

do_set_sort_column_id(sort_column_id, order) virtual
Parameters:
  • sort_column_id (int) – the sort column id to set
  • order (Gtk.SortType) – 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 Gtk.TreeSortable ::sort-column-changed signal. sort_column_id may either be a regular column id, or one of the following special values:

do_set_sort_func(sort_column_id, sort_func, *user_data) virtual
Parameters:
  • sort_column_id (int) – the sort column id to set the function for
  • sort_func (Gtk.TreeIterCompareFunc) – The comparison function
  • user_data (object or None) – User data to pass to sort_func, or None

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.

do_sort_column_changed() virtual

Emits a Gtk.TreeSortable ::sort-column-changed signal on sortable.

Signal Details

Gtk.TreeSortable.signals.sort_column_changed(tree_sortable)
Signal Name:sort-column-changed
Flags:RUN_LAST
Parameters:tree_sortable (Gtk.TreeSortable) – The object which received the signal

The ::sort-column-changed signal is emitted when the sort column or sort order of sortable is changed. The signal is emitted before the contents of sortable are resorted.