Gtk.CellEditable¶

Implementations:: Gtk.ComboBox, Gtk.Entry, Gtk.SpinButton

Methods¶

	`editing_done` ()
	`remove_widget` ()
	`start_editing` (event)

Virtual Methods¶

	`do_editing_done` ()
	`do_remove_widget` ()
	`do_start_editing` (event)

Properties¶

Name	Type	Flags	Short Description
`editing-canceled`	`bool`	r/w/en

Signals¶

Name	Short Description
`editing-done`	This signal is a sign for the cell renderer to update its value from the cell_editable.
`remove-widget`	This signal is meant to indicate that the cell is finished editing, and the cell_editable widget is being removed and may subsequently be destroyed.

Fields¶

None

Class Details¶

class Gtk.CellEditable¶

Bases:: GObject.GInterface
Structure:: Gtk.CellEditableIface

Interface for widgets that can be used for editing cells

The GtkCellEditable interface must be implemented for widgets to be usable to edit the contents of a GtkTreeView cell. It provides a way to specify how temporary widgets should be configured for editing, get the new value, etc.

Deprecated since version 4.10: List views use widgets for displaying their contents. See [iface`Gtk`.Editable] for editable text widgets

editing_done()[source]¶: Emits the GtkCellEditable::editing-done signal.

Deprecated since version 4.10.

remove_widget()[source]¶: Emits the GtkCellEditable::remove-widget signal.

Deprecated since version 4.10.

start_editing(event)[source]¶

Parameters:: event (Gdk.Event or None) – The GdkEvent that began the editing process, or None if editing was initiated programmatically

Begins editing on a self.

The GtkCellRenderer for the cell creates and returns a GtkCellEditable from Gtk.CellRenderer.start_editing(), configured for the GtkCellRenderer type.

Gtk.CellEditable.start_editing() can then set up self suitably for editing a cell, e.g. making the Esc key emit GtkCellEditable::editing-done.

Note that the self is created on-demand for the current edit; its lifetime is temporary and does not persist across other edits and/or cells.

do_editing_done() virtual¶: Emits the GtkCellEditable::editing-done signal.

Deprecated since version 4.10.

do_remove_widget() virtual¶: Emits the GtkCellEditable::remove-widget signal.

Deprecated since version 4.10.

do_start_editing(event) virtual¶

Parameters:: event (Gdk.Event or None) – The GdkEvent that began the editing process, or None if editing was initiated programmatically

Begins editing on a cell_editable.

The GtkCellRenderer for the cell creates and returns a GtkCellEditable from Gtk.CellRenderer.start_editing(), configured for the GtkCellRenderer type.

Gtk.CellEditable.start_editing() can then set up cell_editable suitably for editing a cell, e.g. making the Esc key emit GtkCellEditable::editing-done.

Note that the cell_editable is created on-demand for the current edit; its lifetime is temporary and does not persist across other edits and/or cells.

Signal Details¶

Gtk.CellEditable.signals.editing_done(cell_editable)¶

Signal Name:: editing-done
Flags:: RUN_LAST
Parameters:: cell_editable (Gtk.CellEditable) – The object which received the signal

This signal is a sign for the cell renderer to update its value from the cell_editable.

Implementations of GtkCellEditable are responsible for emitting this signal when they are done editing, e.g. GtkEntry emits this signal when the user presses Enter. Typical things to do in a handler for ::editing-done are to capture the edited value, disconnect the cell_editable from signals on the GtkCellRenderer, etc.

Gtk.CellEditable.editing_done() is a convenience method for emitting GtkCellEditable::editing-done.

Gtk.CellEditable.signals.remove_widget(cell_editable)¶

Signal Name:: remove-widget
Flags:: RUN_LAST
Parameters:: cell_editable (Gtk.CellEditable) – The object which received the signal

This signal is meant to indicate that the cell is finished editing, and the cell_editable widget is being removed and may subsequently be destroyed.

Implementations of GtkCellEditable are responsible for emitting this signal when they are done editing. It must be emitted after the GtkCellEditable::editing-done signal, to give the cell renderer a chance to update the cell’s value before the widget is removed.

Gtk.CellEditable.remove_widget() is a convenience method for emitting GtkCellEditable::remove-widget.

Property Details¶

Gtk.CellEditable.props.editing_canceled¶

Name:: editing-canceled
Type:: bool
Default Value:: False
Flags:: READABLE, WRITABLE, EXPLICIT_NOTIFY

Indicates whether editing on the cell has been canceled.