GtkScrolledWindow仅在光标位于滚动条上时响应鼠标滚轮问题

嘿，这个问题我之前做GTK3项目时也踩过坑！本质原因是焦点与事件传递的问题：GTK3默认只有拥有焦点的部件才会响应鼠标滚轮事件，你的GtkScrolledWindow只有在点击滚动条或拖动它之后才会获取焦点，这时候滚轮才生效。但当鼠标光标在内部的GtkGrid上时，滚轮事件会被Grid接收，可它本身不会处理滚动，也不会自动转发给父容器的ScrolledWindow，所以就出现了这种“只有操作过滚动条才响应滚轮”的情况。

下面给你两种简单有效的解决方法：

方法一：让GtkGrid转发滚轮事件给ScrolledWindow #

这种方法最直接，只需要给Grid添加滚动事件监听，然后把事件传递给ScrolledWindow，让它自己处理滚动逻辑：

// 假设你的ScrolledWindow指针是scrolled_win，内部的GtkGrid指针是grid
// 先让Grid能够接收滚动事件
gtk_widget_add_events(grid, GDK_SCROLL_MASK);

// 连接scroll-event信号，把事件转发给ScrolledWindow
g_signal_connect(grid, "scroll-event", G_CALLBACK(on_grid_scroll_event), scrolled_win);

// 回调函数实现
gboolean on_grid_scroll_event(GtkWidget *grid, GdkEventScroll *event, gpointer user_data) {
    GtkWidget *scrolled_win = GTK_WIDGET(user_data);
    // 将滚动事件传递给ScrolledWindow，让它处理滚动
    return gtk_widget_event(scrolled_win, (GdkEvent*)event);
}

这样一来，只要鼠标在Grid区域内滚动，事件就会被转发给ScrolledWindow，它就能正常响应滚轮了。

方法二：用事件控制器手动控制滚动 #

如果你想更灵活地控制滚动速度或行为，可以使用GTK3的GtkEventControllerScroll来监听滚动事件，然后手动调整ScrolledWindow的滚动位置：

// 创建垂直滚动事件控制器
GtkEventController *scroll_controller = gtk_event_controller_scroll_new(GTK_EVENT_CONTROLLER_SCROLL_VERTICAL);

// 连接scroll信号，处理滚动逻辑
g_signal_connect(scroll_controller, "scroll", G_CALLBACK(on_scrolled_window_scroll), scrolled_win);

// 把控制器添加到Grid上
gtk_widget_add_controller(grid, scroll_controller);

// 回调函数实现
void on_scrolled_window_scroll(GtkEventControllerScroll *controller, gdouble dx, gdouble dy, gpointer user_data) {
    GtkScrolledWindow *scrolled_win = GTK_SCROLLED_WINDOW(user_data);
    // 获取垂直滚动调整器
    GtkAdjustment *v_adj = gtk_scrolled_window_get_vadjustment(scrolled_win);
    
    // 计算新的滚动位置：dy为负是向上滚，正为向下滚；step_increment是单步滚动距离，乘以3是调整滚动速度
    gdouble new_value = gtk_adjustment_get_value(v_adj) + (dy * gtk_adjustment_get_step_increment(v_adj) * 3);
    
    // 确保滚动位置在有效范围内
    new_value = CLAMP(new_value, gtk_adjustment_get_lower(v_adj), gtk_adjustment_get_upper(v_adj) - gtk_adjustment_get_page_size(v_adj));
    
    // 设置新的滚动位置
    gtk_adjustment_set_value(v_adj, new_value);
}

额外提示 #

• 如果你不想让Grid获取焦点，可以设置gtk_widget_set_can_focus(grid, FALSE)，不过这对滚轮事件的传递影响不大，核心还是事件转发的问题。
• 测试时注意确保你的ScrolledWindow确实正确包含了Grid（GTK3的ScrolledWindow会自动给没有独立窗口的子部件添加视口，所以直接用gtk_container_add()也没问题）。

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