如何限制GtkColumnView的ListItem初始化数量以优化加载速度？

问题描述 #

我正在尝试优化包含大量行的GtkColumnView组件加载速度。根据GTK列表组件文档所述：

对于短列表，为模型中的每个项实例化组件不成问题，但当列表增长到数千或数百万个元素时，这种方式就不太可行。因此，视图仅创建有限数量的listitem并通过绑定到新项来复用它们。通常，视图仅为实际可见的项保留可用的listitem。

但我的代码中，尽管bind/unbind复用功能正常，却初始化了205个项，而实际仅少数项可见：

use gtk::*;
use gtk::prelude::*;
use gtk::gio::ListStore;
use gtk::glib::BoxedAnyObject;

fn main() {
    let application = Application::builder().application_id("column.view.test").build();
    application.connect_activate(|application| {
        let list_store = ListStore::new(BoxedAnyObject::static_type());
        for i in 0..10000 {
            list_store.append(&BoxedAnyObject::new(i));
        }
        let column_view = ColumnView::builder().model(&NoSelection::new(Some(list_store))).build();
        let scrolled_window = ScrolledWindow::builder().child(&column_view).build();
        let item_factory = SignalListItemFactory::new();
        item_factory.connect_setup(|_, item| {
            let list_item = item.downcast_ref::<ListItem>().unwrap();
            list_item.set_child(Some(&Label::new(None)));
            println!("setup");
        });
        item_factory.connect_bind(|_, item| {
            let list_item = item.downcast_ref::<ListItem>().unwrap();
            list_item.child().and_downcast::<Label>().unwrap().set_label("a");
            println!("bind");
        });
        item_factory.connect_unbind(|_, _| { println!("unbind"); });
        item_factory.connect_teardown(|_, _| { println!("teardown"); });
        column_view.append_column(&ColumnViewColumn::builder().factory(&item_factory).build());
        ApplicationWindow::builder().application(application).child(&scrolled_window).build().present();
    });
    application.run();
}

请问如何仅初始化可见项（或少量额外项），或通过硬编码数量来减少该组件的加载时间？

解决方法 #

1. 给列表项设置固定高度 #

出现大量提前初始化项的核心原因是：GTK无法预估列表项的高度，会创建大量项来计算滚动区域的总高度。给项设置固定高度后，GTK能准确计算可见项数量，只会创建当前可见的项加少量缓冲项。

修改setup回调，给Label或ListItem设置固定高度：

item_factory.connect_setup(|_, item| {
    let list_item = item.downcast_ref::<ListItem>().unwrap();
    let label = Label::new(None);
    label.set_height_request(24); // 设置固定高度（根据需求调整）
    list_item.set_child(Some(&label));
    println!("setup");
});

或者直接给ListItem设置高度：

list_item.set_height_request(24);

2. 使用虚拟列表模型 #

你的代码中用ListStore一次性添加了10000个项，即使GTK复用组件，模型本身也提前加载了所有数据。改用虚拟列表模型，仅在GTK请求时才创建对应位置的数据项，从根源减少不必要的初始化。

示例自定义虚拟模型：

use gio::prelude::*;
use gio::subclass::prelude::*;
use gtk::glib;

#[derive(Debug, Default)]
struct VirtualListModel;

#[glib::object_subclass]
impl ObjectSubclass for VirtualListModel {
    const NAME: &'static str = "VirtualListModel";
    type Type = super::VirtualListModel;
    type Interfaces = (gio::ListModel,);
}

impl ObjectImpl for VirtualListModel {}

impl ListModelImpl for VirtualListModel {
    // 返回总项数
    fn n_items(&self) -> u32 {
        10000
    }

    // 仅在GTK请求对应位置时创建项
    fn item(&self, position: u32) -> Option<glib::Object> {
        Some(BoxedAnyObject::new(position).upcast())
    }
}

glib::wrapper! {
    pub struct VirtualListModel(ObjectSubclass<VirtualListModel>) @implements gio::ListModel;
}

impl VirtualListModel {
    pub fn new() -> Self {
        glib::Object::new()
    }
}

然后在main函数中替换原有的ListStore：

let list_model = VirtualListModel::new();
let column_view = ColumnView::builder().model(&NoSelection::new(Some(list_model))).build();

3. 限制缓冲项数量（可选） #

GTK默认会创建少量额外的缓冲项，用于滚动时的平滑过渡。如果需要严格控制数量，可以通过set_max_buffer_size调整：

column_view.set_max_buffer_size(5); // 设置上下各最多5个缓冲项

内容的提问来源于stack exchange，提问作者raven