Skip to content

Gtk.NumericSorter

class — extends Sorter

Sorts items numerically.

To obtain the numbers to compare, this sorter evaluates a Expression.

Constructors

new

@classmethod
def new(cls, expression: Expression | None = ...) -> NumericSorter

Creates a new numeric sorter using the given expression.

Smaller numbers will be sorted first. You can call NumericSorter.set_sort_order to change this.

Parameters:

  • expression — The expression to evaluate

Methods

get_expression

def get_expression(self) -> Expression | None

Gets the expression that is evaluated to obtain numbers from items.

get_sort_order

def get_sort_order(self) -> SortType

Gets whether this sorter will sort smaller numbers first.

set_expression

def set_expression(self, expression: Expression | None = ...) -> None

Sets the expression that is evaluated to obtain numbers from items.

Unless an expression is set on self, the sorter will always compare items as invalid.

The expression must have a return type that can be compared numerically, such as G_TYPE_INT or G_TYPE_DOUBLE.

Parameters:

  • expression — a GtkExpression

set_sort_order

def set_sort_order(self, sort_order: SortType | int) -> None

Sets whether to sort smaller numbers before larger ones.

Parameters:

  • sort_order — whether to sort smaller numbers first

Properties

expression

expression: Expression  # read/write

The expression to evaluate on items to get a number to compare with.

sort_order

sort_order: SortType | int  # read/write

Whether the sorter will sort smaller numbers first.