g_idle_add函数详解与使用示例-平芜编程栈

g_idle_add()是 GLib 库中的一个重要函数，用于在 GTK+/GLib 应用程序的主循环中添加空闲回调函数。

函数原型

guint g_idle_add (GSourceFunc function, gpointer user_data);

参数说明

function: 要调用的回调函数，类型为GSourceFunc（返回gboolean，接受gpointer参数）
user_data: 传递给回调函数的用户数据
返回值: 事件源 ID，可用于移除该回调（例如使用g_source_remove()）

回调函数签名

gboolean idle_callback (gpointer user_data);

回调函数应返回：

TRUE: 保持回调函数，下次主循环空闲时再次调用
FALSE: 移除回调函数，只执行一次

工作原理

空闲时机: 当 GTK+ 主循环没有更高优先级的事件（如用户输入、绘图事件）需要处理时
优先级: 默认使用G_PRIORITY_DEFAULT_IDLE（优先级 200）
线程安全: 可从任何线程调用，回调将在主线程执行

使用示例

基本用法：执行一次性任务

static gboolean update_ui(gpointer data) { GtkWidget *label = GTK_WIDGET(data); gtk_label_set_text(GTK_LABEL(label), "更新完成"); // 返回 FALSE 表示只执行一次 return FALSE; } // 在需要时调用 g_idle_add(update_ui, label);

重复执行任务

static gint counter = 0; static gboolean periodic_task(gpointer data) { GtkWidget *label = GTK_WIDGET(data); gchar *text = g_strdup_printf("计数: %d", ++counter); gtk_label_set_text(GTK_LABEL(label), text); g_free(text); // 执行 10 次后停止 if (counter >= 10) { counter = 0; return FALSE; // 移除回调 } return TRUE; // 继续执行 }

带用户数据的完整示例

typedef struct { GtkProgressBar *progress; gdouble value; } ProgressData; static gboolean update_progress(gpointer user_data) { ProgressData *data = (ProgressData *)user_data; >guint g_idle_add_full(gint priority, GSourceFunc function, gpointer data, GDestroyNotify notify); // 示例：使用高优先级 g_idle_add_full(G_PRIORITY_HIGH_IDLE, high_priority_task, data, free_data_callback);

优先级常量

G_PRIORITY_HIGH(-100)
G_PRIORITY_DEFAULT(0)
G_PRIORITY_HIGH_IDLE(100)
G_PRIORITY_DEFAULT_IDLE(200) ←g_idle_add()默认
G_PRIORITY_LOW(300)

线程安全模式

从其他线程安全调用

static gboolean update_from_thread(gpointer data) { // 此回调在主线程执行 GtkLabel *label = GTK_LABEL(data); gtk_label_set_text(label, "来自线程的更新"); return FALSE; } // 在工作线程中调用 g_idle_add(update_from_thread, label);

使用`g_idle_add()`代替线程同步

// 工作线程完成后的 UI 更新 void worker_thread_finished(GtkWidget *widget, gpointer result) { // 错误：不能从非主线程直接更新 UI // gtk_label_set_text(GTK_LABEL(widget), result); // 正确：通过 g_idle_add 在主线程更新 struct { GtkWidget *widget; gchar *result; } *data = g_new0(typeof(*data), 1); data->widget = widget; data->result = g_strdup(result); g_idle_add(update_ui_safely, data); } static gboolean update_ui_safely(gpointer user_data) { // 此函数在主线程执行 struct { GtkWidget *widget; gchar *result; } *data = user_data; gtk_label_set_text(GTK_LABEL(data->widget), data->result); g_free(data->result); g_free(data); return FALSE; }