事件盒 The EventBox

一些 GTK 控件没有与之相关联的 X 窗口，所以它们只在其父控件上显示其外观。由于这个原因，它们不能接收任何事件，并且，如果它们尺寸设置不正确，它们也不会自动剪裁(译者注：裁剪就是使控件只显示一部分)，这样可能会把界面弄得乱糟糟的。如果要想控件接收事件，可以使用事件盒(EventBox)。

初一看，事件盒控件好像完全没有什么用。它在屏幕上什么也不画，并且对事件也不做响应。但是，它有一个功能：为它的子控件提供一个 X 窗口。因为许多G T K控件并没有相关联的 X 窗口，所以这一点很重要。虽然没有 X 窗口会节省内存，提高系统性能，但它也有一些弱点。没有 X 窗口的控件不能接收事件，并且对它的任何内容不能实施剪裁。虽然事件盒控件的名称事件盒强调了它的事件处理功能，它也能用于剪裁控件(更多的信息请看下面的示例)。

用以下函数创建一个新的事件盒控件：

    GtkWidget *gtk_event_box_new( void ); 

然后子控件就可以添加到这个事件盒里面：

    gtk_container_add (GTK_CONTAINER (event_box), child_widget);

示例

效果

源码

下面的示例演示了事件盒的用途：创建一个标签，将它剪裁，放到一个小盒子里面，然后设置让鼠标点击时程序退出。改变窗口的尺寸会使标签控件的尺寸发生变化。

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

int main( int argc,
          char *argv[] )
{
    GtkWidget *window;
    GtkWidget *event_box;
    GtkWidget *label;

    gtk_init (&argc, &argv);

    window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
    gtk_window_set_title (GTK_WINDOW (window), "www.softool.cn - Event Box");
    g_signal_connect (G_OBJECT (window), "destroy",
                            G_CALLBACK (exit), NULL);
    gtk_container_set_border_width (GTK_CONTAINER (window), 10);

    /* 创建一个事件盒，然后将它加到顶级窗口上 */
    event_box = gtk_event_box_new ();
    gtk_container_add (GTK_CONTAINER (window), event_box);
    gtk_widget_show (event_box);

    /* 创建一个长标签 */
    label = gtk_label_new ("Click here to quit, quit, quit, quit, quit");
    gtk_container_add (GTK_CONTAINER (event_box), label);
    gtk_widget_show (label);

    /* 将标签剪裁短。 */
    gtk_widget_set_size_request (label, 110, 20);

    /* 为它绑定一个动作：退出 */
    gtk_widget_set_events (event_box, GDK_BUTTON_PRESS_MASK);
    g_signal_connect (G_OBJECT (event_box), "button_press_event",
                            G_CALLBACK (exit), NULL);

    /* 又是一个要有 X 窗口的东西... */
       //译者注： 要设置鼠标式样也要有 X 窗口。gtk_widget_realize使控件在没有show之前就形成 X 窗口。
    gtk_widget_realize (event_box);
    gdk_window_set_cursor (event_box->window, gdk_cursor_new (GDK_HAND1));

    gtk_widget_show (window);

    gtk_main ();

    return 0;
}