GtkSignalListItemFactory

说明 [src]

final class Gtk.SignalListItemFactory : Gtk.ListItemFactory
{
  /* No available fields */
}

GtkSignalListItemFactory 是一个用于发射信号以管理列表项的 GtkListItemFactory

按相同的顺序对每个列表项发出信号

  1. GtkSignalListItemFactory::setup 发出以在列表项上设置永久项目。这通常意味着构建行中使用的微件并将它们添加到列表项中。

  2. GtkSignalListItemFactory::bind 发出以通过 GtkListItem:item 传递的项目绑定到步骤 1 中创建的微件或向项目特定微件中添加项目。连接信号以侦听变更 - 侦听项目变更以更新微件或侦听微件变更以更新项目。在调用此信号后,可以将列表项显示在列表微件中。

  3. GtkSignalListItemFactory::unbind 发出以撤消步骤 2 中完成的所有操作。通常这意味着断开信号处理程序。在调用此信号后,列表项将不再在列表微件中使用。

  4. GtkSignalListItemFactory::bindGtkSignalListItemFactory::unbind 可能会再次多次发出以绑定列表项以便与新项目一起使用。通过重用列表项,可以避免代价高昂的设置。但是,这意味着代码需要确保在步骤 3 中妥善清除列表项,以便前一次使用的情况不会泄露到下一次中。

  5. GtkSignalListItemFactory::teardown 发出以允许撤消 GtkSignalListItemFactory::setup 的影响。在列表项上发出此信号后,将销毁列表项并不再使用。

请注意,在信号发出期间,更改所传递列表项上的属性不会触发通知信号,因为列表项的通知被冻结。有关详细信息,请参阅 g_object_freeze_notify()

要跟踪列表项中的其他属性的更改,建议使用 ::notify 信号。可以在 GtkSignalListItemFactory::setup 信号中连接该信号,并在 GtkSignalListItemFactory::teardown 信号中再次移除该连接。

层次

hierarchy this GtkSignalListItemFactory ancestor_0 GtkListItemFactory ancestor_0--this ancestor_1 GObject ancestor_1--ancestor_0

构造函数

gtk_signal_list_item_factory_new

创建新的 GtkSignalListItemFactory

实例方法

GObject (43) 继承而来的方法

有关完整方法列表,请参阅 GObject

信号

Gtk.SignalListItemFactory::bind

当对象已绑定时发出,例如当在列表项上设置新的 GtkListItem:item 并且应为其绑定以便使用时。

Gtk.SignalListItemFactory::setup

当创建新列表项并且需要为其设置以便使用时发出。

Gtk.SignalListItemFactory::teardown

当对象即将被销毁时发出。

Gtk.SignalListItemFactory::unbind

在对象与其项取消绑定时发出,例如,当列表项从列表小组件中删除时,并且其 GtkListItem:item 即将取消设置。

GObject (1) 继承的信号
GObject::notify

当对象的某个属性通过 g_object_set_property()、g_object_set() 等将其值设置为时,会在该对象上发出通知信号。

类结构

struct GtkSignalListItemFactoryClass {
  /* no available fields */
}

没有可用的说明。