容器构件 Container Widgets

事件盒 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), "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;
}