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 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
"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 >> |