你首先做的第一件事,当然是下载 GTK 源程序,并安装它。你总是能从 ftp.gtk.org 得到最新版本。你也可以在 http://www.gtk.org/ 上查看其它 GTK 源程序的信息。GTK 使用 GNU autoconf 配置。解压缩后,输入 ./configure --help 查看选项列表
GTK 源码发布包中包含教程中所有示例的代码,每个示例中包含有 Makefiles 文件,用以方便编译。
一开始介绍 GTK,我们会尽可能从简单的程序开始。这个程序创建 200x200 大小的窗口,没有办法退出,除非你从 shell 中将它杀掉。
#include <gtk/gtk.h>
int main( int argc,
char *argv[] )
{
GtkWidget *window;
gtk_init (&argc, &argv);
window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
gtk_widget_show (window);
gtk_main ();
return 0;
} |
你可以用 gcc 编译上面的程序:
gcc base.c -o base `pkg-config --cflags --libs gtk+-2.0`
不常用的编译参数在下面 编译 Hello World 程序 中解释。
所有程序应该包含 gtk/gtk.h ,其中声明了变量、函数以及数据结构等,这些东西会在你的程序中使用。
下一行:
这 个函数 gtk_init(gint *argc, gchar ***argv) 会在每个 GTK 应用程序中调用。该函数设定了默认的视频(visual)和颜色映射模式(color map),接着会调用函数 gdk_init(gint *argc, gchar ***argv)。该函数初始化要使用的库,设定默认的信号处理,并检查传递给你的程序的命令行参数,寻找下列之一:
- --gtk-module
- --g-fatal-warnings
- --gtk-debug
- --gtk-no-debug
- --gdk-debug
- --gdk-no-debug
- --display
- --sync
- --name
- --class
这些参数将会从参数表中删除,留下它不能识别的给你的程序解析或忽略。这就创建了可以被所有 GTK 程序接受的一组标准参数。
下面两行程序会创建并显示一个窗口
window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
gtk_widget_show (window); |
GTK_WINDOW_TOPLEVEL 参数指我们要使用窗口管理器来修饰和放置窗口。这里不会创建一个 0x0 大小的窗口,一个没有子构件的窗口默认大小设置为 200x200,这样你仍然能操作它。
gtk_widget_show() 函数让 GTK 知道,我们已经设置完构件的属性,可以显示它了。
最后一行进入 GTK 主处理循环。
gtk_main() 是另一个可以在每个 GTK 程序中见到的函数调用。当程序运行到这里,GTK 会“睡着”等待 X 事件 (如按钮或键盘按下)、超时(timeouts)或文件 IO 通知发生。在我们的示例中,事件被忽略。
好,现在来写一个只有一个按钮构件的程序,这是一个标准的 GTK Hello World。
#include <gtk/gtk.h>
/* 这是一个回调函数。data 参数在本示例中被忽略。
* 后面有更多的回调函数示例。*/
void hello( GtkWidget *widget,
gpointer data )
{
g_print ("Hello World/n");
}
gint delete_event( GtkWidget *widget,
GdkEvent *event,
gpointer data )
{
/* 如果你的 "delete_event" 信号处理函数返回 FALSE,GTK 会发出 "destroy" 信号。
* 返回 TRUE,你不希望关闭窗口。
* 当你想弹出“你确定要退出吗?”对话框时它很有用。*/
g_print ("delete event occurred/n");
/* 改 TRUE 为 FALSE 程序会关闭。*/
return TRUE;
}
/* 另一个回调函数 */
void destroy( GtkWidget *widget,
gpointer data )
{
gtk_main_quit ();
}
int main( int argc,
char *argv[] )
{
/* GtkWidget 是构件的存储类型 */
GtkWidget *window;
GtkWidget *button;
/* 这个函数在所有的 GTK 程序都要调用。参数由命令行中解析出来并且送到该程序中*/
gtk_init (&argc, &argv);
/* 创建一个新窗口 */
window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
/* 当窗口收到 "delete_event" 信号 (这个信号由窗口管理器发出,通常是“关闭”
* 选项或是标题栏上的关闭按钮发出的),我们让它调用在前面定义的 delete_event() 函数。
* 传给回调函数的 data 参数值是 NULL,它会被回调函数忽略。*/
g_signal_connect (G_OBJECT (window), "delete_event",
G_CALLBACK (delete_event), NULL);
/* 在这里我们连接 "destroy" 事件到一个信号处理函数。
* 对这个窗口调用 gtk_widget_destroy() 函数或在 "delete_event" 回调函数中返回 FALSE 值
* 都会触发这个事件。*/
g_signal_connect (G_OBJECT (window), "destroy",
G_CALLBACK (destroy), NULL);
/* 设置窗口边框的宽度。*/
gtk_container_set_border_width (GTK_CONTAINER (window), 10);
/* 创建一个标签为 "Hello World" 的新按钮。*/
button = gtk_button_new_with_label ("Hello World");
/* 当按钮收到 "clicked" 信号时会调用 hello() 函数,并将NULL传给
* 它作为参数。hello() 函数在前面定义了。*/
g_signal_connect (G_OBJECT (button), "clicked",
G_CALLBACK (hello), NULL);
/* 当点击按钮时,会通过调用 gtk_widget_destroy(window) 来关闭窗口。
* "destroy" 信号会从这里或从窗口管理器发出。*/
g_signal_connect_swapped (G_OBJECT (button), "clicked",
G_CALLBACK (gtk_widget_destroy),
window);
/* 把按钮放入窗口 (一个 gtk 容器) 中。*/
gtk_container_add (GTK_CONTAINER (window), button);
/* 最后一步是显示新创建的按钮和窗口 */
gtk_widget_show (button);
gtk_widget_show (window);
/* 所有的 GTK 程序必须有一个 gtk_main() 函数。程序运行停在这里
* 等待事件 (如键盘事件或鼠标事件) 的发生。*/
gtk_main ();
return 0;
} |