gtk:sorter, gobject:object, common-lisp:standard-object, common-lisp:t

None

The gtk:column-view-sorter class is a sorter implementation that is geared towards the needs of the gtk:column-view widget. The sorter returned by the gtk:column-view-sorter function is a gtk:column-view-sorter object.

In column views, sorting can be configured by associating sorters with columns, and users can invert sort order by clicking on column headers. The gtk:column-view-sorter API is designed to allow saving and restoring this configuration.

If you are only interested in the primary sort column, that is, the column where a sort indicator is shown in the header, then you can just look at the primary-sort-column and primary-sort-order properties.

If you want to store the full sort configuration, including secondary sort columns that are used for tie breaking, then you can use the gtk:column-view-sorter-nth-sort-column function. To get notified about changes, use the "changed" signal.

Since 4.10 To restore a saved sort configuration on a gtk:column-view widget, use code like:

(let ((sorter (gtk:column-view-sorter view)))
  (dotimes (pos (gtk:column-view-sorter-n-sort-columns sorter))
    (multiple-value-bind (column order)
        (gtk:column-view-sorter-nth-sort-column sorter pos)
      (gtk:column-view-sort-by-column view column order)
      ... )))