![]() | ![]() | ![]() | 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 >> |