一般按钮 Normal Buttons

在前面我们见到得最多的控件就是按钮了，它们十分简单。

创建按钮有好几种方法：

• gtk_button_new_with_label() 或 gtk_button_new_with_mnemonic() 创建一个带标签的按钮；
• gtk_button_new_from_stock() 从一个原料(stock)项创建一个包含图像和文本的按钮；
• gtk_button_new() 创建一个空白按钮；

空白按钮

如果想在空白按钮中添加一个标签或位图(pixmap)，那么我们需要借助box控件。此时我们就需要创建一个新的box控件，然后用常见的 gtk_box_pack_start() 把你的label标签或位图对象添加到box控件里，再用 gtk_container_add() 把该box添加到按钮里即可。

下面是一个用函数 gtk_button_new() 创建的一个带图像和标签的按钮的示例，窗口效果：

我先把创建box控件的代码分离了出来，函数为 xpm_label_box()，这样你可以在你自己的项目中去使用它。后面还有更多使用图像的示例。

#include <stdlib.h>
#include <gtk/gtk.h>

/* 创建一个新的水平排列控件的box，它包含一个图像和一个标签，并返回这个box句柄。*/
GtkWidget *xpm_label_box( gchar     *xpm_filename,
                          gchar     *label_text )
{
    GtkWidget *box;
    GtkWidget *label;
    GtkWidget *image;

    /* 为图像和标签创建box */
    box = gtk_hbox_new (FALSE, 0);
    //设置box的边框宽度: 2px
    gtk_container_set_border_width (GTK_CONTAINER (box), 2);

    /* 创建一个图像控件： */
    image = gtk_image_new_from_file (xpm_filename);

    /* 创建一个标签控件 */
    label = gtk_label_new (label_text);

    /* 把图像和标签都添加到box控件里： */
    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);

    /* 设置窗口边框的宽度：10px */
    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的函数 */
    box = xpm_label_box ("info.xpm", "cool button");

    /* 添加和显示所有的控件 */
    gtk_widget_show (box);

    //把上面的box添加到我们的按钮button里:
    gtk_container_add (GTK_CONTAINER (button), box);
    //显示我们的按钮button:
    gtk_widget_show (button);
    //再把我们的按钮button添加到窗口window里：
    gtk_container_add (GTK_CONTAINER (window), button);
    //显示window窗口：
    gtk_widget_show (window);

    /* 停在这里，等待事件发生。 */
    gtk_main ();

    return 0;
}

我们自己制作的 xpm_label_box()函数 可用于添加图像、标签到任何可以作为容器的控件里。

按钮控件有如下信号：

• pressed — 当鼠标键在按钮构件里按下时发出
• released — 当鼠标键在按钮构件里释放时发出
• clicked — 当鼠标键在按钮构件里按下并接着在按钮构件里释放时发出
• enter — 当鼠标光标进入按钮构件时发出
• leave — 当鼠标光标离开按钮构件时发出