一般按钮 Normal Buttons

在前面我们见到得最多的就是按钮元件了。它们十分简单。创建按钮有好几种方法。你可以用 gtk_button_new_with_label() 或 gtk_button_new_with_mnemonic() 来创建一个带标签的按钮，从库存物件中使用 gtk_button_new_from_stock() 创建一个包含影像和文字的按钮，或者用 gtk_button_new() 创建一个空白按钮。接着你可以决定把一个标签或像素图(pixmap)封装到这个新创建的按钮里。要这样做，创建一个新的盒，然后用常见的 gtk_box_pack_start() 把你的物件封装到盒里，再用 gtk_container_add() 把盒封装到按钮里。

这里是一个用函式 gtk_button_new() 去创建一个带影像和标签的按钮的范例。我把创建盒的程式码分离了出来，这样你可以在你自己的程式中使用它。后面还有更多使用影像的范例。

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

/* 创建一个新的横向盒，它包含一个影像和一个标签，并传回这个盒。*/

static GtkWidget *xpm_label_box( gchar     *xpm_filename,
                                 gchar     *label_text )
{
    GtkWidget *box;
    GtkWidget *label;
    GtkWidget *image;

    /* 为影像和标签创建盒 */
    box = gtk_hbox_new (FALSE, 0);
    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;
}

/* 我们常见的回呼函式 */
static 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 (window, "destroy",
	              G_CALLBACK (gtk_main_quit), NULL);

    g_signal_connect (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 (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 — 当滑鼠在按钮元件里按下时发出
• released — 当滑鼠在按钮元件里释放时发出
• clicked — 当滑鼠在按钮元件里按下并接着在按钮元件里释放时发出
• enter — 当滑鼠游标进入按钮元件时发出
• leave — 当滑鼠游标离开按钮元件时发出

单元首页