g-object, common-lisp:standard-object, common-lisp:t

None

The gtk-tree-selection object is a helper object to manage the selection for a gtk-tree-view widget. The gtk-tree-selection object is automatically created when a new gtk-tree-view widget is created, and cannot exist independentally of this widget. The primary reason the gtk-tree-selection objects exists is for cleanliness of code and API. That is, there is no conceptual reason all these functions could not be methods on the gtk-tree-view widget instead of a separate function.

The gtk-tree-selection object is gotten from a gtk-tree-view widget by calling the function gtk-tree-view-selection. It can be manipulated to check the selection status of the tree view, as well as select and deselect individual rows. Selection is done completely tree view side. As a result, multiple tree views of the same model can have completely different selections. Additionally, you cannot change the selection of a row on the model that is not currently displayed by the tree view without expanding its parents first.

One of the important things to remember when monitoring the selection of a tree view is that the "changed" signal is mostly a hint. That is, it may only emit one signal when a range of rows is selected. Additionally, it may on occasion emit a "changed" signal.

The "changed" signal

 lambda (selection)    : Run First      

Emitted whenever the selection has (possibly) changed. Please note that this signal is mostly a hint. It may only be emitted once when a range of rows are selected, and it may occasionally be emitted when nothing has happened.

selection

The gtk-tree-selection object which received the signal.