gtkmm 4.17.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. | |
const GtkSignalListItemFactory * | gobj () const |
Provides access to the underlying C GObject. | |
GtkSignalListItemFactory * | gobj_copy () |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. | |
Glib::SignalProxy< void(const Glib::RefPtr< ListItem > &)> | signal_setup () |
This signal is only usable if the factory is being used to make ListItems. | |
Glib::SignalProxy< void(const Glib::RefPtr< ListItem > &)> | signal_bind () |
This signal is only usable if the factory is being used to make ListItems. | |
Glib::SignalProxy< void(const Glib::RefPtr< ListItem > &)> | signal_unbind () |
This signal is only usable if the factory is being used to make ListItems. | |
Glib::SignalProxy< void(const Glib::RefPtr< ListItem > &)> | signal_teardown () |
This signal is only usable if the factory is being used to make ListItems. | |
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. | |
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. | |
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. | |
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. | |
![]() | |
ListItemFactory (ListItemFactory &&src) noexcept | |
ListItemFactory & | operator= (ListItemFactory &&src) noexcept |
~ListItemFactory () noexcept override | |
GtkListItemFactory * | gobj () |
Provides access to the underlying C GObject. | |
const GtkListItemFactory * | gobj () const |
Provides access to the underlying C GObject. | |
GtkListItemFactory * | gobj_copy () |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. | |
![]() | |
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) |
![]() | |
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 |
![]() | |
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. | |
static Glib::RefPtr< SignalListItemFactory > | create () |
![]() | |
static GType | get_type () |
Get the GType for this class, for use with the underlying GObject type system. | |
Protected Member Functions | |
SignalListItemFactory () | |
![]() | |
Object () | |
Object (const Glib::ConstructParams &construct_params) | |
Object (GObject *castitem) | |
~Object () noexcept override | |
![]() | |
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 Symbols | |
(Note that these are not member symbols.) | |
Glib::RefPtr< Gtk::SignalListItemFactory > | wrap (GtkSignalListItemFactory *object, bool take_copy=false) |
A Glib::wrap() method for this object. | |
![]() | |
Glib::RefPtr< Gtk::ListItemFactory > | wrap (GtkListItemFactory *object, bool take_copy=false) |
A Glib::wrap() method for this object. | |
Additional Inherited Members | |
![]() | |
typedef void(*)(gpointer data | DestroyNotify) |
![]() | |
typedef internal::func_destroy_notify | func_destroy_notify |
![]() | |
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 below signals, not suffixed _obj()
and taking ListItem arguments, only work if the factory is indeed making ListItem instances. If not, e.g. if it makes ListHeader objects as the ListView::property_header_factory(), these signals receive null args and cannot be used. In such cases, use the versions suffixed _obj()
, and cast the Glib::Object argument to the right subclass.
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. |