13. Il Widget EventBox

Alcuni widget gtk non sono associati a finestre X, sicché semplicemente disegnano sui loro genitori. Per questo motivo essi non possono ricevere eventi e se sono sovradimensionati non vengono troncati, ma rischiano di sovrapporsi, generando confusione. Se si vuole di più da questi widget si può ricorrere agli EventBox.

A prima vista il widget EventBox potrebbe sembrare completamente inutile. Non disegna nulla sullo schermo e non risponde a nessun evento. Tuttavia ha una funzione: fornire una finestra X al suo widget figlio. Ciò è importante in quanto molti widget GTK non hanno una finestra X associata. Se questo da una parte risparmia memoria e migliora le prestazioni, dall'altra introduce degli svantaggi: un widget senza una finestra X non può ricevere eventi, e non taglia in alcun modo il suo contenuto. Sebbene il nome ``EventBox'' (casella di eventi) enfasizzi la funzione di gestione degli eventi, il widget può essere usato anche per limitare la dimensione dei widget figli (ma anche per altro: si veda l'esempio seguente).

Per creare un widget di tipo EventBox:

GtkWidget* gtk_event_box_new (void);

All'EventBox si può aggiungere un widget figlio:

gtk_container_add (GTK_CONTAINER(event_box), widget);

The following example demonstrates both uses of an EventBox - a label is created that clipped to a small box, and set up so that a mouse-click on the label causes the program to exit. Il seguente esempio mostra entrambi gli usi di un EventBox - si crea un'etichetta limitata da un rettangolo piccolo, fatta in modo che cliccando con il mouse su di essa il programma termina.

/* eventbox.c */

#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");
    
    gtk_signal_connect (GTK_OBJECT (window), "destroy",
                        GTK_SIGNAL_FUNC (gtk_exit), NULL);
    
    gtk_container_border_width (GTK_CONTAINER (window), 10);
    
    /* Crea un EventBox e lo aggiunge alla finestra principale */

    event_box = gtk_event_box_new ();
    gtk_container_add (GTK_CONTAINER(window), event_box);
    gtk_widget_show (event_box);
    
    /* Crea una etichetta lunga */
    
    label = gtk_label_new ("Click here to quit, quit, quit, quit, quit");
    gtk_container_add (GTK_CONTAINER (event_box), label);
    gtk_widget_show (label);
    
    /* Limitane le dimensioni */
    gtk_widget_set_usize (label, 110, 20);
    
    /* E collega ad essa una azione */
    gtk_widget_set_events (event_box, GDK_BUTTON_PRESS_MASK);
    gtk_signal_connect (GTK_OBJECT(event_box), "button_press_event",
                        GTK_SIGNAL_FUNC (gtk_exit), NULL);
    
    /* Un'altra cosa per cui si ha bisogno di una finestra 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;
}