|
gtkmm 4.14.0
|
A listitem factory providing signals. More...
#include <gtkmm/signallistitemfactory.h>

Public Member Functions | |
| SignalListItemFactory (SignalListItemFactory && src) noexcept | |
| SignalListItemFactory & | operator= (SignalListItemFactory && src) noexcept |
| ~SignalListItemFactory () noexcept override | |
| GtkSignalListItemFactory * | gobj () |
| Provides access to the underlying C GObject. More... | |
| const GtkSignalListItemFactory * | gobj () const |
| Provides access to the underlying C GObject. More... | |
| GtkSignalListItemFactory * | gobj_copy () |
| Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More... | |
| Glib::SignalProxy< void(const Glib::RefPtr< ListItem > &)> | signal_setup () |
| This signal is only usable if the factory is being used to make ListItems. More... | |
| Glib::SignalProxy< void(const Glib::RefPtr< ListItem > &)> | signal_bind () |
| This signal is only usable if the factory is being used to make ListItems. More... | |
| Glib::SignalProxy< void(const Glib::RefPtr< ListItem > &)> | signal_unbind () |
| This signal is only usable if the factory is being used to make ListItems. More... | |
| Glib::SignalProxy< void(const Glib::RefPtr< ListItem > &)> | signal_teardown () |
| This signal is only usable if the factory is being used to make ListItems. More... | |
| Glib::SignalProxy< void(const Glib::RefPtr< Glib::Object > &)> | signal_setup_obj () |
| This is a more generic version of signal_setup(), usable if the factory is being used to make something other than ListItems, for example ListHeader. More... | |
| Glib::SignalProxy< void(const Glib::RefPtr< Glib::Object > &)> | signal_bind_obj () |
| This is a more generic version of signal_bind(), usable if the factory is being used to make something other than ListItems, for example ListHeader. More... | |
| Glib::SignalProxy< void(const Glib::RefPtr< Glib::Object > &)> | signal_unbind_obj () |
| This is a more generic version of signal_unbind(), usable if the factory is being used to make something other than ListItems, for example ListHeader. More... | |
| Glib::SignalProxy< void(const Glib::RefPtr< Glib::Object > &)> | signal_teardown_obj () |
| This is a more generic version of signal_teardown(), usable if the factory is being used to make something other than ListItems, for example ListHeader. More... | |
Public Member Functions inherited from Gtk::ListItemFactory | |
| ListItemFactory (ListItemFactory && src) noexcept | |
| ListItemFactory & | operator= (ListItemFactory && src) noexcept |
| ~ListItemFactory () noexcept override | |
| GtkListItemFactory * | gobj () |
| Provides access to the underlying C GObject. More... | |
| const GtkListItemFactory * | gobj () const |
| Provides access to the underlying C GObject. More... | |
| GtkListItemFactory * | gobj_copy () |
| Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More... | |
Public Member Functions inherited from Glib::Object | |
| Object (const Object &)=delete | |
| Object & | operator= (const Object &)=delete |
| Object (Object &&src) noexcept | |
| Object & | operator= (Object &&src) noexcept |
| void * | get_data (const QueryQuark &key) |
| void | set_data (const Quark &key, void *data) |
| void | set_data_with_c_callback (const Quark &key, void *data, GDestroyNotify notify) |
| void | set_data (const Quark &key, void *data, DestroyNotify notify) |
| void | remove_data (const QueryQuark &quark) |
| void * | steal_data (const QueryQuark &quark) |
| Glib::RefPtr< Glib::Object > | wrap (GObject *object, bool take_copy=false) |
Public Member Functions inherited from Glib::ObjectBase | |
| ObjectBase (const ObjectBase &)=delete | |
| ObjectBase & | operator= (const ObjectBase &)=delete |
| void | set_property_value (const Glib::ustring &property_name, const Glib::ValueBase &value) |
| void | get_property_value (const Glib::ustring &property_name, Glib::ValueBase &value) const |
| void | set_property (const Glib::ustring &property_name, const PropertyType &value) |
| void | get_property (const Glib::ustring &property_name, PropertyType &value) const |
| PropertyType | get_property (const Glib::ustring &property_name) const |
| sigc::connection | connect_property_changed (const Glib::ustring &property_name, const sigc::slot< void()> &slot) |
| sigc::connection | connect_property_changed (const Glib::ustring &property_name, sigc::slot< void()> &&slot) |
| void | freeze_notify () |
| void | thaw_notify () |
| virtual void | reference () const |
| virtual void | unreference () const |
| GObject * | gobj () |
| const GObject * | gobj () const |
| GObject * | gobj_copy () const |
Public Member Functions inherited from sigc::trackable | |
| trackable () noexcept | |
| trackable (const trackable &src) noexcept | |
| trackable (trackable &&src) noexcept | |
| ~trackable () | |
| void | add_destroy_notify_callback (notifiable *data, func_destroy_notify func) const |
| void | notify_callbacks () |
| trackable & | operator= (const trackable &src) |
| trackable & | operator= (trackable &&src) noexcept |
| void | remove_destroy_notify_callback (notifiable *data) const |
Static Public Member Functions | |
| static GType | get_type () |
| Get the GType for this class, for use with the underlying GObject type system. More... | |
| static Glib::RefPtr< SignalListItemFactory > | create () |
Static Public Member Functions inherited from Gtk::ListItemFactory | |
| static GType | get_type () |
| Get the GType for this class, for use with the underlying GObject type system. More... | |
Protected Member Functions | |
| SignalListItemFactory () | |
Protected Member Functions inherited from Glib::Object | |
| Object () | |
| Object (const Glib::ConstructParams &construct_params) | |
| Object (GObject *castitem) | |
| ~Object () noexcept override | |
Protected Member Functions inherited from Glib::ObjectBase | |
| ObjectBase () | |
| ObjectBase (const char *custom_type_name) | |
| ObjectBase (const std::type_info &custom_type_info) | |
| ObjectBase (ObjectBase &&src) noexcept | |
| ObjectBase & | operator= (ObjectBase &&src) noexcept |
| virtual | ~ObjectBase () noexcept=0 |
| void | initialize (GObject *castitem) |
| void | initialize_move (GObject *castitem, Glib::ObjectBase *previous_wrapper) |
Related Functions | |
(Note that these are not member functions.) | |
| Glib::RefPtr< Gtk::SignalListItemFactory > | wrap (GtkSignalListItemFactory * object, bool take_copy=false) |
| A Glib::wrap() method for this object. More... | |
Related Functions inherited from Gtk::ListItemFactory | |
| Glib::RefPtr< Gtk::ListItemFactory > | wrap (GtkListItemFactory * object, bool take_copy=false) |
| A Glib::wrap() method for this object. More... | |
Additional Inherited Members | |
Public Types inherited from Glib::Object | |
| typedef void(*)(gpointer data | DestroyNotify) |
Public Types inherited from sigc::trackable | |
| typedef internal::func_destroy_notify | func_destroy_notify |
Public Types inherited from sigc::notifiable | |
| typedef internal::func_destroy_notify | func_destroy_notify |
A listitem factory providing signals.
Gtk::SignalListItemFactory is a Gtk::ListItemFactory that provides signals with which user code can manage instances of ListItem or other list objects.
Note the following signals, not suffixed _obj(), are only suitable if the factory is really being used to make ListItem instances. If not, e.g. it is producing ListHeader items in use as a ListView::property_header_factory(), these signals receive null RefPtrs and so are not usable. In such cases, use the versions suffixed _obj(), and cast the Glib::Objects to the right type.
Signals are emitted for every listitem in the same order:
Note that during the signal emissions, changing properties on the Gtk::ListItems passed will not trigger notify signals as the listitem's notifications are frozen. See Glib::ObjectBase::freeze_notify() for details.
For tracking changes in other properties in the Gtk::ListItem, the Gtk::ListItem notify signal is recommended. The signal can be connected in the signal_setup() signal and removed again during signal_teardown().
|
noexcept |
|
overridenoexcept |
|
protected |
|
static |
|
static |
Get the GType for this class, for use with the underlying GObject type system.
|
inline |
Provides access to the underlying C GObject.
|
inline |
Provides access to the underlying C GObject.
| GtkSignalListItemFactory * Gtk::SignalListItemFactory::gobj_copy | ( | ) |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.
|
noexcept |
| Glib::SignalProxy< void(const Glib::RefPtr< ListItem > &)> Gtk::SignalListItemFactory::signal_bind | ( | ) |
This signal is only usable if the factory is being used to make ListItems.
If not, e.g. because the factory is making ListHeader items via being used as a ListView::property_header_factory(), this signal will receive a null RefPtr and so not be usable. In such cases, use signal_bind_obj() instead.
void on_my_bind(const Glib::RefPtr<ListItem>& list_item)Flags: Run First
Emitted when an object has been bound, for example when a new Gtk::ListItem::property_item() has been set on a listitem and should be bound for use.
After this signal was emitted, the object might be shown in a Gtk::ListView or other widget.
The signal_unbind() signal is the opposite of this signal and can be used to undo everything done in this signal.
| list_item | The Glib::Object to bind. |
| Glib::SignalProxy< void(const Glib::RefPtr< Glib::Object > &)> Gtk::SignalListItemFactory::signal_bind_obj | ( | ) |
This is a more generic version of signal_bind(), usable if the factory is being used to make something other than ListItems, for example ListHeader.
It receives a RefPtr to Glib::Object, which can be cast to the actual type.
void on_my_bind_obj(const Glib::RefPtr<Glib::Object>& object)Flags: Run First
Emitted when an object has been bound, for example when a new Gtk::ListItem::property_item() has been set on a listitem and should be bound for use.
After this signal was emitted, the object might be shown in a Gtk::ListView or other widget.
The signal_unbind() signal is the opposite of this signal and can be used to undo everything done in this signal.
| object | The Glib::Object to bind. |
| Glib::SignalProxy< void(const Glib::RefPtr< ListItem > &)> Gtk::SignalListItemFactory::signal_setup | ( | ) |
This signal is only usable if the factory is being used to make ListItems.
If not, e.g. because the factory is making ListHeader items via being used as a ListView::property_header_factory(), this signal will receive a null RefPtr and so not be usable. In such cases, use signal_setup_obj() instead.
void on_my_setup(const Glib::RefPtr<ListItem>& list_item)Flags: Run First
Emitted when a new listitem has been created and needs to be setup for use.
It is the first signal emitted for every listitem.
The signal_teardown() signal is the opposite of this signal and can be used to undo everything done in this signal.
| list_item | The Glib::Object to set up. |
| Glib::SignalProxy< void(const Glib::RefPtr< Glib::Object > &)> Gtk::SignalListItemFactory::signal_setup_obj | ( | ) |
This is a more generic version of signal_setup(), usable if the factory is being used to make something other than ListItems, for example ListHeader.
It receives a RefPtr to Glib::Object, which can be cast to the actual type.
void on_my_setup_obj(const Glib::RefPtr<Glib::Object>& object)Flags: Run First
Emitted when a new listitem has been created and needs to be setup for use.
It is the first signal emitted for every listitem.
The signal_teardown() signal is the opposite of this signal and can be used to undo everything done in this signal.
| object | The Glib::Object to set up. |
| Glib::SignalProxy< void(const Glib::RefPtr< ListItem > &)> Gtk::SignalListItemFactory::signal_teardown | ( | ) |
This signal is only usable if the factory is being used to make ListItems.
If not, e.g. because the factory is making ListHeader items via being used as a ListView::property_header_factory(), this signal will receive a null RefPtr and so not be usable. In such cases, use signal_teardown_obj() instead.
void on_my_teardown(const Glib::RefPtr<ListItem>& list_item)Flags: Run First
Emitted when an object is about to be destroyed.
It is the last signal ever emitted for this list_item.
This signal is the opposite of the signal_setup() signal and should be used to undo everything done in that signal.
| list_item | The Glib::Object to tear down. |
| Glib::SignalProxy< void(const Glib::RefPtr< Glib::Object > &)> Gtk::SignalListItemFactory::signal_teardown_obj | ( | ) |
This is a more generic version of signal_teardown(), usable if the factory is being used to make something other than ListItems, for example ListHeader.
It receives a RefPtr to Glib::Object, which can be cast to the actual type.
void on_my_teardown_obj(const Glib::RefPtr<Glib::Object>& object)Flags: Run First
Emitted when an object is about to be destroyed.
It is the last signal ever emitted for this object.
This signal is the opposite of the signal_setup() signal and should be used to undo everything done in that signal.
| object | The Glib::Object to tear down. |
| Glib::SignalProxy< void(const Glib::RefPtr< ListItem > &)> Gtk::SignalListItemFactory::signal_unbind | ( | ) |
This signal is only usable if the factory is being used to make ListItems.
If not, e.g. because the factory is making ListHeader items via being used as a ListView::property_header_factory(), this signal will receive a null RefPtr and so not be usable. In such cases, use signal_unbind_obj() instead.
void on_my_unbind(const Glib::RefPtr<ListItem>& list_item)Flags: Run First
Emitted when an object has been unbound from its item, for example when a listitem was removed from use in a list widget and its Gtk::ListItem::property_item() is about to be unset.
This signal is the opposite of the signal_bind() signal and should be used to undo everything done in that signal.
| list_item | The Glib::Object to unbind. |
| Glib::SignalProxy< void(const Glib::RefPtr< Glib::Object > &)> Gtk::SignalListItemFactory::signal_unbind_obj | ( | ) |
This is a more generic version of signal_unbind(), usable if the factory is being used to make something other than ListItems, for example ListHeader.
It receives a RefPtr to Glib::Object, which can be cast to the actual type.
void on_my_unbind_obj(const Glib::RefPtr<Glib::Object>& object)Flags: Run First
Emitted when an object has been unbound from its item, for example when a listitem was removed from use in a list widget and its Gtk::ListItem::property_item() is about to be unset.
This signal is the opposite of the signal_bind() signal and should be used to undo everything done in that signal.
| object | The Glib::Object to unbind. |
|
related |
A Glib::wrap() method for this object.
| object | The C instance. |
| take_copy | False if the result should take ownership of the C instance. True if it should take a new copy or ref. |