|  |  |  | GTK+ Reference Manual |  | 
|---|
| GtkCellRendererToggleGtkCellRendererToggle — Renders a toggle button in a cell | 
#include <gtk/gtk.h>
            GtkCellRendererToggle;
GtkCellRenderer* gtk_cell_renderer_toggle_new
                                            (void);
gboolean    gtk_cell_renderer_toggle_get_radio
                                            (GtkCellRendererToggle *toggle);
void        gtk_cell_renderer_toggle_set_radio
                                            (GtkCellRendererToggle *toggle,
                                             gboolean radio);
gboolean    gtk_cell_renderer_toggle_get_active
                                            (GtkCellRendererToggle *toggle);
void        gtk_cell_renderer_toggle_set_active
                                            (GtkCellRendererToggle *toggle,
                                             gboolean setting);
"activatable" gboolean : Read / Write "active" gboolean : Read / Write "inconsistent" gboolean : Read / Write "radio" gboolean : Read / Write
"toggled" void user_function (GtkCellRendererToggle *cell_renderer, gchar *path, gpointer user_data);
GtkCellRendererToggle 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.
GtkCellRenderer* gtk_cell_renderer_toggle_new (void);
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.
| Returns : | the new cell renderer | 
gboolean gtk_cell_renderer_toggle_get_radio (GtkCellRendererToggle *toggle);
Returns whether we're rendering radio toggles rather than checkboxes.
| toggle: | a GtkCellRendererToggle | 
| Returns : | TRUEif we're rendering radio toggles rather than checkboxes | 
void        gtk_cell_renderer_toggle_set_radio
                                            (GtkCellRendererToggle *toggle,
                                             gboolean 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).
| toggle: | a GtkCellRendererToggle | 
| radio: | TRUEto make the toggle look like a radio button | 
gboolean gtk_cell_renderer_toggle_get_active (GtkCellRendererToggle *toggle);
Returns whether the cell renderer is active. See
gtk_cell_renderer_toggle_set_active().
| toggle: | a GtkCellRendererToggle | 
| Returns : | TRUEif the cell renderer is active. | 
void        gtk_cell_renderer_toggle_set_active
                                            (GtkCellRendererToggle *toggle,
                                             gboolean setting);
Activates or deactivates a cell renderer.
| toggle: | a GtkCellRendererToggle. | 
| setting: | the value to set. | 
activatable" property"activatable" gboolean : Read / Write
The toggle button can be activated.
Default value: TRUE
active" property"active" gboolean : Read / Write
The toggle state of the button.
Default value: FALSE
inconsistent" property"inconsistent" gboolean : Read / Write
The inconsistent state of the button.
Default value: FALSE
radio" property"radio" gboolean : Read / Write
Draw the toggle button as a radio button.
Default value: FALSE
void user_function (GtkCellRendererToggle *cell_renderer, gchar *path, gpointer user_data);
The ::toggled signal is emitted when the cell is toggled.
| cell_renderer: | the object which received the signal | 
| path: | string representation of GtkTreePath describing the event location | 
| user_data: | user data set when the signal handler was connected. | 
| << GtkCellRendererText | GtkListStore >> |