| 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
| Returns : | the new cell renderer |
gboolean gtk_cell_renderer_toggle_get_radio (GtkCellRendererToggle *toggle);
Returns wether we're rendering radio toggles rather than checkboxes.
| toggle : | a GtkCellRendererToggle |
| Returns : | TRUE if 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 : | TRUE to 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 : | TRUE if 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"gboolean : Read / Write
The toggle button can be activated.
Default value: TRUE
"active"gboolean : Read / Write
The toggle state of the button.
Default value: FALSE
"inconsistent"gboolean : Read / Write
The inconsistent state of the 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 >> |