PyGTK Tutorial
<<< Previous	Chapter 11. CList Widget	Next >>>

11.2. Modes of operation

There are several methods that can be used to alter the behaviour of a CList. First there is

clist.set_selection_mode(mode)

which, as the name implies, sets the selection mode of the clist. The argument is the cell selection mode. At the time of this writing, the following modes are available to us:

SELECTION_SINGLE - The selection is either None or contains a list with a single selected item.

SELECTION_BROWSE - The selection is None if the list contains no widgets or insensitive ones only, otherwise it contains a list with exactly one list item.

SELECTION_MULTIPLE - The selection is None if no list items are selected or a list of the selected items. This is currently the default for the CList widget.

SELECTION_EXTENDED - The selection is always None.

Others might be added in later revisions of GTK.

We can also define what the border of the CList widget should look like. It is done through

clist.set_shadow_type(border)

The possible values for the border argument are

SHADOW_NONE SHADOW_IN SHADOW_OUT SHADOW_ETCHED_IN SHADOW_ETCHED_OUT