Package: gtk

Class gtk-tree-selection


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

Documented Subclasses


Direct Slots

The mode property of type gtk-selection-mode (Read / Write)
Selection mode. See the gtk-tree-selection-mode function for more information on this property.
Default value: :single


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 by calling the gtk-tree-view-get-selection function. It can be manipulated to check the selection status of the tree, as well as select and deselect individual rows. Selection is done completely view side. As a result, multiple 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 view without expanding its parents first.

One of the important things to remember when monitoring the selection of a 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 when nothing has happened (mostly as a result of programmers calling select_row on an already selected row).

Signal Details

The "changed" signal
 lambda (treeselection)    : 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.
The object which received the signal.

Slot Access Functions

Inherited Slot Access Functions