gtk-0.12.5.2: Binding to the Gtk+ graphical user interface library.

Portabilityportable (depends on GHC)
Stabilityprovisional
Maintainergtk2hs-users@lists.sourceforge.net
Safe HaskellNone

Graphics.UI.Gtk.ModelView.CellRendererToggle

Contents

Description

Renders a toggle button in a cell

Synopsis

Detail

CellRendererToggle renders a toggle button in a cell. The button is drawn as a radio or checkbutton, depending on the radio property. When activated, it emits the toggled signal.

Class Hierarchy

 | GObject
 | +----Object
 | +----CellRenderer
 | +----CellRendererToggle

Types

Constructors

cellRendererToggleNew :: IO CellRendererToggleSource

Creates a new CellRendererToggle. Adjust rendering parameters using object properties. Object properties can be set globally (with set). Also, within a TreeViewColumn, you can bind a property to a value in a TreeModel using cellLayoutSetAttributes. For example, you can bind the cellToggleActive property on the cell renderer to a boolean value in the model, thus causing the check button to reflect the state of the model.

Methods

cellRendererToggleGetRadioSource

Arguments

:: CellRendererToggleClass self 
=> self 
-> IO Bool

returns True if we're rendering radio toggles rather than checkboxes

Returns whether we're rendering radio toggles rather than checkboxes.

cellRendererToggleSetRadioSource

Arguments

:: CellRendererToggleClass self 
=> self 
-> Bool

radio - True to make the toggle look like a radio button

-> IO () 

If radio is True, the cell renderer renders a radio toggle (i.e. a toggle in a group of mutually-exclusive toggles). If False, it renders a check toggle (a standalone boolean option). This can be set globally for the cell renderer, or changed just before rendering each cell in the model (for TreeView, you set up a per-row setting using TreeViewColumn to associate model columns with cell renderer properties).

cellRendererToggleGetActiveSource

Arguments

:: CellRendererToggleClass self 
=> self 
-> IO Bool

returns True if the cell renderer is active.

Returns whether the cell renderer is active. See cellRendererToggleSetActive.

cellRendererToggleSetActiveSource

Arguments

:: CellRendererToggleClass self 
=> self 
-> Bool

setting - the value to set.

-> IO () 

Activates or deactivates a cell renderer.

Attributes

cellToggleActive :: CellRendererToggleClass self => Attr self BoolSource

The toggle state of the button.

Default value: False

cellToggleInconsistent :: CellRendererToggleClass self => Attr self BoolSource

The inconsistent state of the button.

Default value: False

cellToggleActivatable :: CellRendererToggleClass self => Attr self BoolSource

The toggle button can be activated.

Default value: True

cellToggleRadio :: CellRendererToggleClass self => Attr self BoolSource

Draw the toggle button as a radio button.

Default value: False

cellToggleIndicatorSize :: CellRendererToggleClass self => Attr self IntSource

Size of check or radio indicator.

Allowed values: >= 0

Default value: 12

Signals

cellToggled :: CellRendererToggleClass self => Signal self (String -> IO ())Source

The cellToggled signal is emitted when the cell is toggled. The string represents a TreePath into the model and can be converted using stringToTreePath.

Deprecated

onCellToggled :: CellRendererToggleClass self => self -> (String -> IO ()) -> IO (ConnectId self)Source

Deprecated: instead of 'onCellToggled obj' use 'on obj cellToggled'

afterCellToggled :: CellRendererToggleClass self => self -> (String -> IO ()) -> IO (ConnectId self)Source

Deprecated: instead of 'afterCellToggled obj' use 'after obj cellToggled'