按钮构件

一般按钮 Normal Buttons
在前面我们见到得最多的就是按钮构件了。它们十分简单。创建按钮有好几种
方法。你可以用 gtk_button_new_with_label() 或
gtk_button_new_with_mnemonic() 来创建一个带标签的按钮，用
gtk_button_new_from_stock() 来从一个原料(stock)项创建一个包含图像和文
本的按钮，或者用 gtk_button_new() 创建一个空白按钮。接着你可以决定把
一个标签或位图(pixmap)组装到这个新创建的按钮里。要这样做，创建一个新
的盒，然后用常见的 gtk_box_pack_start() 把你的对象组装到盒里，再用
gtk_container_add() 把盒组装到按钮里。
这里是一个用函数 gtk_button_new() 去创建一个带图像和标签的按钮的示
例。我把创建盒的代码分离了出来，这样你可以在你自己的程序中使用它。后
面还有更多使用图像的示例。
#include <stdlib.h>
#include <gtk/gtk.h>
/* 创建一个新的横向盒，它包含一个图像和一个标签，并返回这个盒。*/
GtkWidget *xpm_label_box( gchar *xpm_filename,
gchar *label_text )
{
GtkWidget *box;

GtkWidget *label;
GtkWidget *image;
/* 为图像和标签创建盒 */
box = gtk_box_new (GTK_ORIENTATION_HORIZONTAL,10);
gtk_container_set_border_width (GTK_CONTAINER (box), 2);
/* 创建一个图像 */
image = gtk_image_new_from_file (xpm_filename);
/* 为按钮创建一个标签 */
label = gtk_label_new (label_text);
/* 把图像和标签组装到盒子里 */
gtk_box_pack_start (GTK_BOX (box), image, FALSE, FALSE, 3);
gtk_box_pack_start (GTK_BOX (box), label, FALSE, FALSE, 3);
gtk_widget_show (image);
gtk_widget_show (label);
return box;
}
/* 我们常见的回调函数 */
void callback( GtkWidget *widget,
gpointer data )
{
g_print ("Hello again - %s was pressed\n", (char *) data);
}
int main( int argc,
char *argv[] )
{
/* GtkWidget 是构件的存储类型 */
GtkWidget *window;
GtkWidget *button;
GtkWidget *box;
gtk_init (&argc, &argv);
/* 创建一个新窗口 */
window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
gtk_window_set_title (GTK_WINDOW (window), "Pixmap'd Buttons!");

/* 对所有的窗口做这一步是一个好主意。*/
g_signal_connect (G_OBJECT (window), "destroy",
G_CALLBACK (gtk_main_quit), NULL);
g_signal_connect (G_OBJECT (window), "delete_event",
G_CALLBACK (gtk_main_quit), NULL);
/* 设置窗口边框的宽度。*/
gtk_container_set_border_width (GTK_CONTAINER (window), 10);
/* 创建一个新的按钮 */
button = gtk_button_new ();
/* 连接按钮的 "clicked" 信号到我们的回调 */
g_signal_connect (G_OBJECT (button), "clicked",
G_CALLBACK (callback), (gpointer) "cool
button");
/* 调用我们的创建盒的函数 */
box = xpm_label_box ("info.xpm", "cool button");
/* 组装和显示所有的构件 */
gtk_widget_show (box);
gtk_container_add (GTK_CONTAINER (button), box);
gtk_widget_show (button);
gtk_container_add (GTK_CONTAINER (window), button);
gtk_widget_show (window);
/* 停在这里，等待事件发生。 */
gtk_main ();
return 0;
}
函数 xpm_label_box() 可用于组装图像和标签到任何可以作为容器的构件里。
按钮构件有如下信号：
• pressed --- 当鼠标键在按钮构件里按下时发出
- 46 -
GTK+ 2.0 教程
• released --- 当鼠标键在按钮构件里释放时发出
• clicked --- 当鼠标键在按钮构件里按下并接着在按钮构件里释放时发
出
• enter --- 当鼠标光标进入按钮构件时发出
• leave --- 当鼠标光标离开按钮构件时发出