CellEditable

Deprecated since version 4.10: List views use widgets for displaying their contents. See Editable for editable text widgets

class CellEditable(*args, **kwargs)

Implementations: ComboBox, ComboBoxText, Entry, SpinButton

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.

Methods

class CellEditable

editing_done() → None

Emits the GtkCellEditable::editing-done signal.

Deprecated since version 4.10: Please do not use it in newly written code

remove_widget() → None

Emits the GtkCellEditable::remove-widget signal.

Deprecated since version 4.10: Please do not use it in newly written code

start_editing(event: Event | None = None) → None

Begins editing on a cell_editable.

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

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.

Parameters:

event – The GdkEvent that began the editing process, or None if editing was initiated programmatically

Properties

class CellEditable

props.editing_canceled: bool

The type of the None singleton.

Signals

class CellEditable.signals

editing_done() → None

The type of the None singleton.

remove_widget() → None

The type of the None singleton.

Virtual Methods

class CellEditable

do_editing_done() → None

Emits the GtkCellEditable::editing-done signal.

Deprecated since version 4.10: Please do not use it in newly written code

do_remove_widget() → None

Emits the GtkCellEditable::remove-widget signal.

Deprecated since version 4.10: Please do not use it in newly written code

do_start_editing(event: Event | None = None) → None

Begins editing on a cell_editable.

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

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.

Parameters:

event – The GdkEvent that began the editing process, or None if editing was initiated programmatically