Hello World 详解
现在我们知基本理论了,让我们来详细分析helloworld示例程序。
这是按钮被点击时要调用的回调函数。在示例中忽略参数 widget 和 data,但是 使用这些参数也不难。下一个示例会使用 data参数 来告诉我们按下了哪个按钮。
void hello( GtkWidget *widget, gpointer data ) { g_print ("Hello World\n"); }
接下来的一个回调函数有点特殊。当 "delete_event" 事件发生时,我们可以在这 里选择做什么,可以忽略它们,可以做些响应或是简单的退出程序。
这个回调函数返回的值让 GTK 知道如何去做。返回 TRUE,GTK 知道我们不想发出 "destroy" 信号,保持程序继续运行。返回 FALSE,我们让 "destroy" 信号发出 ,然后会立即调用 "destroy" 信号处理函数。
gint delete_event( GtkWidget *widget, GdkEvent *event, gpointer data ) { g_print ("delete event occurred\n");
return TRUE; }
这是另一个回调函数,它调用函数 gtk_main_quit() 来退出程序。
void destroy( GtkWidget *widget, gpointer data ) { gtk_main_quit (); }
我假设你知道 main() 函数...是的,像其它程序一样,所有的 GTK 程序有一个 main() 函数。
int main( int argc, char *argv[] ) {
接下来声明两个指向GtkWidget的指针。它们被用于创建一个窗口和一个按钮。
GtkWidget *window; GtkWidget *button;
这里是gtk_init()。初始化工具包,分析命令行参数,从参数列表中删除任何可以 识别的参数,并且修改argc和argv。允许程序分析剩余的参数。
gtk_init (&argc, &argv);
创建一个新窗口。这个很直观。它建立了一个新窗口,但是这个窗口不显示,后面 我们调用函数 gtk_widget_show(window) 显示它。
window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
这有两个连接对象与信号处理函数的示例。在这里 "delete_event" 和 "destroy" 信号被捕获。当我们用窗口管理器去关闭窗口或调用函数 gtk_widget_destroy() 时,"delete_event" 信号发出。当我们在 "delete_event" 信号处理函数中返回 FALSE 值时,"destroy" 信号发出。G_OBJECT和G_CALLBACK是宏,为我们执行类 型强制转换和检测,同时也增加了代码的可读性。
g_signal_connect (G_OBJECT (window), "delete_event", G_CALLBACK (delete_event), NULL); g_signal_connect (G_OBJECT (window), "destroy", G_CALLBACK (destroy), NULL);
这个函数用于设置容器对象的属性。设置窗口边框宽度为10个象素。详见设置构件 属性这一章
GTK_CONTAINER也是一个宏执行类型casting。
gtk_container_set_border_width (GTK_CONTAINER (window), 10);
这个函数调用创建一个新按钮。分配内存给一个新的构件结构,初始化它,并使 button指针指向它。按钮的标签为"Hello World"。
button = gtk_button_new_with_label ("Hello World");
在这,我们让这个按钮做一些有用的事。我们给按钮设置信号处理函数,因此当按 钮发出 "clicked" 信号时,hello() 函数被调用。我们忽略了 data参数,简单的 传送 NULL 给 hello() 回调。显而易见,当我们用鼠标点击按钮时,信号 "clicked"被发出。
g_signal_connect (G_OBJECT (button), "clicked", G_CALLBACK (hello), NULL);
我们也要使用这个按钮退出程序。你会看到如何从程序内部发出 "destroy" 信号 。和上面一样,当我们按下按钮时,首先调用 hello() 回调函数,这依赖于我们 设置连接的顺序。你可以拥有许多回调函数,所有的回调按你设置连接的顺序执行 。因为 gtk_widget_destroy() 函数只接受一个参数,我们直接用函数 g_signal_connect_swapped() 替换函数 g_signal_connect()。
g_signal_connect_swapped (G_OBJECT (button), "clicked", G_CALLBACK (gtk_widget_destroy), G_OBJECT (window));
这是一个组装调用,详见组装构件这一章。它相当容易理解。它简单的告诉 GTK 把按钮放在要显示的地方。注意 GTK 容器只能包含一个构件。还有其它的构件, 在后面介绍,可以用各种方法放置多个构件。
gtk_container_add (GTK_CONTAINER (window), button);
一切准备就绪。我们让 GTK 在屏幕上“显示”这些构件。窗口构件最后显示,所 以整个窗口会一下弹出,而不是先见到窗口弹出后见到按钮。虽然这个示例中我们 不会注意到。
gtk_widget_show (button);
gtk_widget_show (window);
我们调用 gtk_main() 函数来等待来自X服务器的事件,当这些事件到来时,调用 构件发出信号。
gtk_main ();
调用函数 gtk_quit() 后控制返回到这里。
return 0;
现在,当我们用鼠标点击一个 GTK 按钮,构件发出一个 "clicked" 信号。我们为 这个信号设置了处理函数。在我们的示例中,当按下按钮时,调用函数 hello(), 然后调用该信号的下一个处理函数,该函数调用函数 gtk_widget_destroy(),把窗 口构件作为参数传递给它,销毁窗口构件。引起窗口发出 "destroy" 信号,并且 调用我们的destroy()回调函数,简单的退出 GTK。
如果用窗口管理器去关闭窗口,它会引发 "delete_event" 事件,这会调用我们的 "delete_event" 处理函数。如果我们在函数中返回 TRUE,窗口什么事都不做, 返回 FALSE,会引发 "destroy" 信号,调用 "destroy" 回调函数,退出 GTK。 
|