Class
Gtk.CellRendererToggle
Description [src]
final class Gtk.CellRendererToggle : Gtk.CellRenderer {
/* No available fields */
}
Renders a toggle button in a cell
GtkCellRendererToggle
renders a toggle button in a cell. The
button is drawn as a radio or a checkbutton, depending on the
GtkCellRendererToggle:radio
property.
When activated, it emits the GtkCellRendererToggle::toggled
signal.
Constructors
gtk_cell_renderer_toggle_new
Creates a new GtkCellRendererToggle
. Adjust rendering
parameters using object properties. Object properties can be set
globally (with g_object_set()
). Also, with GtkTreeViewColumn
, you
can bind a property to a value in a GtkTreeModel
. For example, you
can bind the “active” property on the cell renderer to a boolean value
in the model, thus causing the check button to reflect the state of
the model.
Instance methods
gtk_cell_renderer_toggle_get_activatable
Returns whether the cell renderer is activatable. See
gtk_cell_renderer_toggle_set_activatable()
.
gtk_cell_renderer_toggle_get_active
Returns whether the cell renderer is active. See
gtk_cell_renderer_toggle_set_active()
.
gtk_cell_renderer_toggle_get_radio
Returns whether we’re rendering radio toggles rather than checkboxes.
gtk_cell_renderer_toggle_set_activatable
Makes the cell renderer activatable.
gtk_cell_renderer_toggle_set_active
Activates or deactivates a cell renderer.
gtk_cell_renderer_toggle_set_radio
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 GtkTreeView
, you set
up a per-row setting using GtkTreeViewColumn
to associate model
columns with cell renderer properties).
Methods inherited from GtkCellRenderer (27)
Properties
Gtk.CellRendererToggle:activatable
Gtk.CellRendererToggle:active
Gtk.CellRendererToggle:inconsistent
Gtk.CellRendererToggle:radio
Properties inherited from GtkCellRenderer (15)
Gtk.CellRenderer:cell-background
Gtk.CellRenderer:cell-background-rgba
Cell background as a GdkRGBA
Gtk.CellRenderer:cell-background-set
Gtk.CellRenderer:editing
Gtk.CellRenderer:height
Gtk.CellRenderer:is-expanded
Gtk.CellRenderer:is-expander
Gtk.CellRenderer:mode
Gtk.CellRenderer:sensitive
Gtk.CellRenderer:visible
Gtk.CellRenderer:width
Gtk.CellRenderer:xalign
Gtk.CellRenderer:xpad
Gtk.CellRenderer:yalign
Gtk.CellRenderer:ypad
Signals
Gtk.CellRendererToggle::toggled
The ::toggled signal is emitted when the cell is toggled.
Signals inherited from GtkCellRenderer (2)
Gtk.CellRenderer::editing-canceled
This signal gets emitted when the user cancels the process of editing a cell. For example, an editable cell renderer could be written to cancel editing when the user presses Escape.
Gtk.CellRenderer::editing-started
This signal gets emitted when a cell starts to be edited.
The intended use of this signal is to do special setup
on editable
, e.g. adding a GtkEntryCompletion
or setting
up additional columns in a GtkComboBox
.