gtkmm 4.19.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 to an item.
The handler for this signal must set to populate the listitem with widgets.
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 to an item.
The handler for this signal must set to populate the listitem with widgets.
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 newly created listitem needs to be prepared for use.
It is the first signal emitted for every listitem.
The handler for this signal must call Gtk::ListItem::set_child() to populate the listitem with widgets.
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 newly created listitem needs to be prepared for use.
It is the first signal emitted for every listitem.
The handler for this signal must call Gtk::ListItem::set_child() to populate the listitem with widgets.
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.
This happens 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.
This happens 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. |