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.