gtkmm  3.4.0
Public Member Functions | Static Public Member Functions | Protected Member Functions | Related Functions
Gtk::CellEditable Class Reference

Interface for widgets which are used for editing cells. More...

Inheritance diagram for Gtk::CellEditable:
Inheritance graph
[legend]

List of all members.

Public Member Functions

virtual ~CellEditable ()
GtkCellEditable* gobj ()
 Provides access to the underlying C GObject.
const GtkCellEditable* gobj () const
 Provides access to the underlying C GObject.
void start_editing (GdkEvent* event)
 Begins editing on a cell_editable.
void editing_done ()
 Emits the Gtk::CellEditable::signal_editing_done() signal.
void remove_widget ()
 Emits the Gtk::CellEditable::signal_remove_widget() signal.
Glib::SignalProxy0< void > signal_editing_done ()
Glib::SignalProxy0< void > signal_remove_widget ()
Glib::PropertyProxy< bool > property_editing_canceled ()
 Indicates that editing has been canceled.
Glib::PropertyProxy_ReadOnly
< bool > 
property_editing_canceled () const
 Indicates that editing has been canceled.

Static Public Member Functions

static void add_interface (GType gtype_implementer)

Protected Member Functions

 CellEditable ()
 You should derive from this class to use it.
virtual void start_editing_vfunc (GdkEvent* event)
virtual void on_editing_done ()
 This is a default handler for the signal signal_editing_done().
virtual void on_remove_widget ()
 This is a default handler for the signal signal_remove_widget().

Related Functions

(Note that these are not member functions.)

Glib::RefPtr< Gtk::CellEditablewrap (GtkCellEditable* object, bool take_copy=false)
 A Glib::wrap() method for this object.

Detailed Description

Interface for widgets which are used for editing cells.

The CellEditable interface must be implemented for widgets to be usable when editing the contents of a TreeView cell.


Constructor & Destructor Documentation

You should derive from this class to use it.

virtual Gtk::CellEditable::~CellEditable ( ) [virtual]

Member Function Documentation

static void Gtk::CellEditable::add_interface ( GType  gtype_implementer) [static]
GtkCellEditable* Gtk::CellEditable::gobj ( ) [inline]

Provides access to the underlying C GObject.

Reimplemented in Gtk::SpinButton, Gtk::Entry, Gtk::ComboBox, Gtk::AppChooserButton, and Gtk::ComboBoxText.

const GtkCellEditable* Gtk::CellEditable::gobj ( ) const [inline]

Provides access to the underlying C GObject.

Reimplemented in Gtk::SpinButton, Gtk::Entry, Gtk::ComboBox, Gtk::AppChooserButton, and Gtk::ComboBoxText.

virtual void Gtk::CellEditable::on_editing_done ( ) [protected, virtual]

This is a default handler for the signal signal_editing_done().

virtual void Gtk::CellEditable::on_remove_widget ( ) [protected, virtual]

This is a default handler for the signal signal_remove_widget().

Glib::PropertyProxy< bool > Gtk::CellEditable::property_editing_canceled ( )

Indicates that editing has been canceled.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Glib::PropertyProxy_ReadOnly< bool > Gtk::CellEditable::property_editing_canceled ( ) const

Indicates that editing has been canceled.

You rarely need to use properties because there are get_ and set_ methods for almost all of them.

Returns:
A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes.
Glib::SignalProxy0< void > Gtk::CellEditable::signal_editing_done ( )
Slot Prototype:
void on_my_editing_done()

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

Implementations of Gtk::CellEditable are responsible for emitting this signal when they are done editing, e.g. Gtk::Entry is emitting it when the user presses Enter.

Gtk::CellEditable::editing_done() is a convenience method for emitting Gtk::CellEditable::signal_editing_done().

Glib::SignalProxy0< void > Gtk::CellEditable::signal_remove_widget ( )
Slot Prototype:
void on_my_remove_widget()

This signal is meant to indicate that the cell is finished editing, and the widget may now be destroyed.

Implementations of Gtk::CellEditable are responsible for emitting this signal when they are done editing. It must be emitted after the Gtk::CellEditable::signal_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 Gtk::CellEditable::signal_remove_widget().

void Gtk::CellEditable::start_editing ( GdkEvent *  event)

Begins editing on a cell_editable.

event is the Gdk::Event that began the editing process. It may be 0, in the instance that editing was initiated through programatic means.

Parameters:
eventA Gdk::Event, or 0.
virtual void Gtk::CellEditable::start_editing_vfunc ( GdkEvent *  event) [protected, virtual]

Friends And Related Function Documentation

Glib::RefPtr< Gtk::CellEditable > wrap ( GtkCellEditable *  object,
bool  take_copy = false 
) [related]

A Glib::wrap() method for this object.

Parameters:
objectThe C instance.
take_copyFalse if the result should take ownership of the C instance. True if it should take a new copy or ref.
Returns:
A C++ instance that wraps this C instance.

The documentation for this class was generated from the following file: