CellRendererToggle
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.
Skipped during bindings generation
method
inconsistent
: Property has no getter nor setter
Constructors
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.
Properties
Functions
Passes an activate event to the cell renderer for possible processing. Some cell renderers may use events; for example, GtkCellRendererToggle
toggles when it gets a mouse click.
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.
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
.
The ::toggled signal is emitted when the cell is toggled.
Returns whether the cell renderer is activatable. See gtk_cell_renderer_toggle_set_activatable().
Gets the aligned area used by @cell inside @cell_area. Used for finding the appropriate edit and focus rectangle.
Checks whether the given GtkCellRenderer
is expanded.
Checks whether the given GtkCellRenderer
is an expander.
Retrieves the minimum and natural size of a cell taking into account the widget’s preference for height-for-width management.
Gets whether the cell renderer prefers a height-for-width layout or a width-for-height layout.
Returns the cell renderer’s sensitivity.
Translates the cell renderer state to GtkStateFlags
, based on the cell renderer and widget sensitivity, and the given GtkCellRenderer
State.
Returns the cell renderer’s visibility.
Checks whether the cell renderer can do something when activated.
Makes the cell renderer activatable.
Sets the renderer’s alignment within its available space.
Sets the renderer size to be explicit, independent of the properties set.
Sets whether the given GtkCellRenderer
is expanded.
Sets whether the given GtkCellRenderer
is an expander.
Sets the renderer’s padding.
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).
Sets the cell renderer’s sensitivity.
Sets the cell renderer’s visibility.
Starts editing the contents of this @cell, through a new GtkCellEditable
widget created by the GtkCellRenderer
Class.start_editing virtual function.
Informs the cell renderer that the editing is stopped. If @canceled is true, the cell renderer will emit the GtkCellRenderer
::editing-canceled signal.