Pileus Git - ~andy/gtk/blob - gtk/gtkmain.c

   1 /* GTK - The GIMP Toolkit
   2  * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Library General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Library General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Library General Public
  15  * License along with this library; if not, write to the
  16  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  17  * Boston, MA 02111-1307, USA.
  18  */
  19
  20 /*
  21  * Modified by the GTK+ Team and others 1997-1999.  See the AUTHORS
  22  * file for a list of people on the GTK+ Team.  See the ChangeLog
  23  * files for a list of changes.  These files are distributed with
  24  * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
  25  */
  26
  27 #ifdef GDK_WINDOWING_X11
  28 #include <X11/Xlocale.h>        /* so we get the right setlocale */
  29 #else
  30 #include <locale.h>
  31 #endif
  32 #include <stdio.h>
  33 #include <stdlib.h>
  34 #include <string.h>
  35 #include <gmodule.h>
  36 #include "gtkbutton.h"
  37 #include "gtkdnd.h"
  38 #include "gtkcompat.h"
  39 #include "gtkhscrollbar.h"
  40 #include "gtkhseparator.h"
  41 #include "gtkmain.h"
  42 #include "gtkpreview.h"
  43 #include "gtkrc.h"
  44 #include "gtkscrolledwindow.h"
  45 #include "gtkselection.h"
  46 #include "gtksignal.h"
  47 #include "gtktable.h"
  48 #include "gtktext.h"
  49 #include "gtkvbox.h"
  50 #include "gtkvscrollbar.h"
  51 #include "gtkwidget.h"
  52 #include "gtkwindow.h"
  53 #include "gtkprivate.h"
  54 #include "gdk/gdki18n.h"
  55 #include "config.h"
  56 #include "gtkdebug.h"
  57 #include "gtkintl.h"
  58
  59 /* Private type definitions
  60  */
  61 typedef struct _GtkInitFunction          GtkInitFunction;
  62 typedef struct _GtkQuitFunction          GtkQuitFunction;
  63 typedef struct _GtkClosure               GtkClosure;
  64 typedef struct _GtkKeySnooperData        GtkKeySnooperData;
  65
  66 struct _GtkInitFunction
  67 {
  68   GtkFunction function;
  69   gpointer data;
  70 };
  71
  72 struct _GtkQuitFunction
  73 {
  74   guint id;
  75   guint main_level;
  76   GtkCallbackMarshal marshal;
  77   GtkFunction function;
  78   gpointer data;
  79   GtkDestroyNotify destroy;
  80 };
  81
  82 struct _GtkClosure
  83 {
  84   GtkCallbackMarshal marshal;
  85   gpointer data;
  86   GtkDestroyNotify destroy;
  87 };
  88
  89 struct _GtkKeySnooperData
  90 {
  91   GtkKeySnoopFunc func;
  92   gpointer func_data;
  93   guint id;
  94 };
  95
  96 static void  gtk_exit_func               (void);
  97 static gint  gtk_quit_invoke_function    (GtkQuitFunction    *quitf);
  98 static void  gtk_quit_destroy            (GtkQuitFunction    *quitf);
  99 static gint  gtk_invoke_key_snoopers     (GtkWidget          *grab_widget,
 100                                           GdkEvent           *event);
 101
 102 static void     gtk_destroy_closure      (gpointer            data);
 103 static gboolean gtk_invoke_idle_timeout  (gpointer            data);
 104 static void     gtk_invoke_input         (gpointer            data,
 105                                           gint                source,
 106                                           GdkInputCondition   condition);
 107
 108 #if 0
 109 static void  gtk_error                   (gchar              *str);
 110 static void  gtk_warning                 (gchar              *str);
 111 static void  gtk_message                 (gchar              *str);
 112 static void  gtk_print                   (gchar              *str);
 113 #endif
 114
 115 const guint gtk_major_version = GTK_MAJOR_VERSION;
 116 const guint gtk_minor_version = GTK_MINOR_VERSION;
 117 const guint gtk_micro_version = GTK_MICRO_VERSION;
 118 const guint gtk_binary_age = GTK_BINARY_AGE;
 119 const guint gtk_interface_age = GTK_INTERFACE_AGE;
 120
 121 static guint gtk_main_loop_level = 0;
 122 static gint gtk_initialized = FALSE;
 123 static GList *current_events = NULL;
 124
 125 static GSList *main_loops = NULL;      /* stack of currently executing main loops */
 126
 127 static GSList *grabs = NULL;               /* A stack of unique grabs. The grabbing
 128                                             *  widget is the first one on the list.
 129                                             */
 130 static GList *init_functions = NULL;       /* A list of init functions.
 131                                             */
 132 static GList *quit_functions = NULL;       /* A list of quit functions.
 133                                             */
 134 static GMemChunk *quit_mem_chunk = NULL;
 135
 136 static GSList *key_snoopers = NULL;
 137
 138 static GdkVisual *gtk_visual;              /* The visual to be used in creating new
 139                                             *  widgets.
 140                                             */
 141 static GdkColormap *gtk_colormap;          /* The colormap to be used in creating new
 142                                             *  widgets.
 143                                             */
 144
 145 guint gtk_debug_flags = 0;                 /* Global GTK debug flag */
 146
 147 #ifdef G_ENABLE_DEBUG
 148 static const GDebugKey gtk_debug_keys[] = {
 149   {"objects", GTK_DEBUG_OBJECTS},
 150   {"misc", GTK_DEBUG_MISC},
 151   {"signals", GTK_DEBUG_SIGNALS},
 152   {"dnd", GTK_DEBUG_DND},
 153   {"plugsocket", GTK_DEBUG_PLUGSOCKET},
 154   {"text", GTK_DEBUG_TEXT}
 155 };
 156
 157 static const guint gtk_ndebug_keys = sizeof (gtk_debug_keys) / sizeof (GDebugKey);
 158
 159 #endif /* G_ENABLE_DEBUG */
 160
 161 gchar*
 162 gtk_check_version (guint required_major,
 163                    guint required_minor,
 164                    guint required_micro)
 165 {
 166   if (required_major > GTK_MAJOR_VERSION)
 167     return "Gtk+ version too old (major mismatch)";
 168   if (required_major < GTK_MAJOR_VERSION)
 169     return "Gtk+ version too new (major mismatch)";
 170   if (required_minor > GTK_MINOR_VERSION)
 171     return "Gtk+ version too old (minor mismatch)";
 172   if (required_minor < GTK_MINOR_VERSION)
 173     return "Gtk+ version too new (minor mismatch)";
 174   if (required_micro < GTK_MICRO_VERSION - GTK_BINARY_AGE)
 175     return "Gtk+ version too new (micro mismatch)";
 176   if (required_micro > GTK_MICRO_VERSION)
 177     return "Gtk+ version too old (micro mismatch)";
 178   return NULL;
 179 }
 180
 181 #ifdef __EMX__
 182 static gchar *add_dll_suffix(gchar *module_name)
 183 {
 184     gchar *suffix = strrchr(module_name, '.');
 185
 186     if (!suffix || stricmp(suffix, ".dll"))
 187     {
 188         gchar *old = module_name;
 189
 190         module_name = g_strconcat (module_name, ".dll", NULL);
 191         g_free (old);
 192     }
 193     return (module_name);
 194 }
 195 #endif
 196
 197 gboolean
 198 gtk_init_check (int      *argc,
 199                 char   ***argv)
 200 {
 201   GSList *gtk_modules = NULL;
 202   GSList *slist;
 203   gchar *env_string = NULL;
 204
 205   if (gtk_initialized)
 206     return TRUE;
 207
 208 #if     0
 209   g_set_error_handler (gtk_error);
 210   g_set_warning_handler (gtk_warning);
 211   g_set_message_handler (gtk_message);
 212   g_set_print_handler (gtk_print);
 213 #endif
 214
 215   /* Initialize "gdk". We pass along the 'argc' and 'argv'
 216    *  parameters as they contain information that GDK uses
 217    */
 218   if (!gdk_init_check (argc, argv))
 219     return FALSE;
 220
 221   gdk_event_handler_set ((GdkEventFunc)gtk_main_do_event, NULL, NULL);
 222
 223 #ifdef G_ENABLE_DEBUG
 224   env_string = getenv ("GTK_DEBUG");
 225   if (env_string != NULL)
 226     {
 227       gtk_debug_flags = g_parse_debug_string (env_string,
 228                                               gtk_debug_keys,
 229                                               gtk_ndebug_keys);
 230       env_string = NULL;
 231     }
 232 #endif  /* G_ENABLE_DEBUG */
 233
 234   env_string = getenv ("GTK_MODULES");
 235   if (env_string)
 236     {
 237       gchar **modules, **as;
 238
 239 #ifndef __EMX__
 240       modules = g_strsplit (env_string, G_SEARCHPATH_SEPARATOR_S, -1);
 241 #else
 242       modules = g_strsplit (env_string, ";", -1);
 243 #endif
 244       for (as = modules; *as; as++)
 245         {
 246           if (**as)
 247             gtk_modules = g_slist_prepend (gtk_modules, *as);
 248           else
 249             g_free (*as);
 250         }
 251       g_free (modules);
 252       env_string = NULL;
 253     }
 254
 255   if (argc && argv)
 256     {
 257       gint i, j, k;
 258
 259       for (i = 1; i < *argc;)
 260         {
 261           if (strcmp ("--gtk-module", (*argv)[i]) == 0 ||
 262               strncmp ("--gtk-module=", (*argv)[i], 13) == 0)
 263             {
 264               gchar *module_name = (*argv)[i] + 12;
 265
 266               if (*module_name == '=')
 267                 module_name++;
 268               else if (i + 1 < *argc)
 269                 {
 270                   (*argv)[i] = NULL;
 271                   i += 1;
 272                   module_name = (*argv)[i];
 273                 }
 274               (*argv)[i] = NULL;
 275
 276               if (module_name && *module_name)
 277                 gtk_modules = g_slist_prepend (gtk_modules, g_strdup (module_name));
 278             }
 279           else if (strcmp ("--g-fatal-warnings", (*argv)[i]) == 0)
 280             {
 281               GLogLevelFlags fatal_mask;
 282
 283               fatal_mask = g_log_set_always_fatal (G_LOG_FATAL_MASK);
 284               fatal_mask |= G_LOG_LEVEL_WARNING | G_LOG_LEVEL_CRITICAL;
 285               g_log_set_always_fatal (fatal_mask);
 286               (*argv)[i] = NULL;
 287             }
 288 #ifdef G_ENABLE_DEBUG
 289           else if ((strcmp ("--gtk-debug", (*argv)[i]) == 0) ||
 290                    (strncmp ("--gtk-debug=", (*argv)[i], 12) == 0))
 291             {
 292               gchar *equal_pos = strchr ((*argv)[i], '=');
 293
 294               if (equal_pos != NULL)
 295                 {
 296                   gtk_debug_flags |= g_parse_debug_string (equal_pos+1,
 297                                                            gtk_debug_keys,
 298                                                            gtk_ndebug_keys);
 299                 }
 300               else if ((i + 1) < *argc && (*argv)[i + 1])
 301                 {
 302                   gtk_debug_flags |= g_parse_debug_string ((*argv)[i+1],
 303                                                            gtk_debug_keys,
 304                                                            gtk_ndebug_keys);
 305                   (*argv)[i] = NULL;
 306                   i += 1;
 307                 }
 308               (*argv)[i] = NULL;
 309             }
 310           else if ((strcmp ("--gtk-no-debug", (*argv)[i]) == 0) ||
 311                    (strncmp ("--gtk-no-debug=", (*argv)[i], 15) == 0))
 312             {
 313               gchar *equal_pos = strchr ((*argv)[i], '=');
 314
 315               if (equal_pos != NULL)
 316                 {
 317                   gtk_debug_flags &= ~g_parse_debug_string (equal_pos+1,
 318                                                             gtk_debug_keys,
 319                                                             gtk_ndebug_keys);
 320                 }
 321               else if ((i + 1) < *argc && (*argv)[i + 1])
 322                 {
 323                   gtk_debug_flags &= ~g_parse_debug_string ((*argv)[i+1],
 324                                                             gtk_debug_keys,
 325                                                             gtk_ndebug_keys);
 326                   (*argv)[i] = NULL;
 327                   i += 1;
 328                 }
 329               (*argv)[i] = NULL;
 330             }
 331 #endif /* G_ENABLE_DEBUG */
 332           i += 1;
 333         }
 334
 335       for (i = 1; i < *argc; i++)
 336         {
 337           for (k = i; k < *argc; k++)
 338             if ((*argv)[k] != NULL)
 339               break;
 340
 341           if (k > i)
 342             {
 343               k -= i;
 344               for (j = i + k; j < *argc; j++)
 345                 (*argv)[j-k] = (*argv)[j];
 346               *argc -= k;
 347             }
 348         }
 349     }
 350
 351   /* load gtk modules */
 352   gtk_modules = g_slist_reverse (gtk_modules);
 353   for (slist = gtk_modules; slist; slist = slist->next)
 354     {
 355       gchar *module_name;
 356       GModule *module = NULL;
 357       GtkModuleInitFunc modinit_func = NULL;
 358
 359       module_name = slist->data;
 360       slist->data = NULL;
 361 #ifndef __EMX__
 362       if (!g_path_is_absolute (module_name))
 363         {
 364           gchar *old = module_name;
 365
 366           module_name = g_module_build_path (NULL, module_name);
 367           g_free (old);
 368         }
 369 #else
 370       module_name = add_dll_suffix(module_name);
 371 #endif
 372       if (g_module_supported ())
 373         {
 374           module = g_module_open (module_name, G_MODULE_BIND_LAZY);
 375           if (module &&
 376               g_module_symbol (module, "gtk_module_init", (gpointer*) &modinit_func) &&
 377               modinit_func)
 378             {
 379               if (!g_slist_find (gtk_modules, modinit_func))
 380                 {
 381                   g_module_make_resident (module);
 382                   slist->data = modinit_func;
 383                 }
 384               else
 385                 {
 386                   g_module_close (module);
 387                   module = NULL;
 388                 }
 389             }
 390         }
 391       if (!modinit_func)
 392         {
 393           g_warning ("Failed to load module \"%s\": %s",
 394                      module ? g_module_name (module) : module_name,
 395                      g_module_error ());
 396           if (module)
 397             g_module_close (module);
 398         }
 399       g_free (module_name);
 400     }
 401
 402 #ifdef ENABLE_NLS
 403 #ifndef G_OS_WIN32
 404   bindtextdomain("gtk+", GTK_LOCALEDIR);
 405 #else
 406   {
 407     /* GTk+ locale dir is %WinDir%\gtk+\locale */
 408     extern char *get_gtk_sysconf_directory ();
 409     bindtextdomain ("gtk+", g_strconcat (get_gtk_sysconf_directory (),
 410                                          G_DIR_SEPARATOR_S,
 411                                          "locale",
 412                                          NULL));
 413   }
 414 #endif
 415 #endif
 416
 417   /* Initialize the default visual and colormap to be
 418    *  used in creating widgets. (We want to use the system
 419    *  defaults so as to be nice to the colormap).
 420    */
 421   gtk_visual = gdk_visual_get_system ();
 422   gtk_colormap = gdk_colormap_get_system ();
 423
 424   gtk_type_init ();
 425   gtk_signal_init ();
 426   gtk_rc_init ();
 427
 428
 429   /* Register an exit function to make sure we are able to cleanup.
 430    */
 431   g_atexit (gtk_exit_func);
 432
 433   /* Set the 'initialized' flag.
 434    */
 435   gtk_initialized = TRUE;
 436
 437   /* initialize gtk modules
 438    */
 439   for (slist = gtk_modules; slist; slist = slist->next)
 440     {
 441       if (slist->data)
 442         {
 443           GtkModuleInitFunc modinit;
 444
 445           modinit = slist->data;
 446           modinit (argc, argv);
 447         }
 448     }
 449   g_slist_free (gtk_modules);
 450
 451 #ifndef G_OS_WIN32
 452   /* No use warning on Win32, there aren't any non-devel versions anyhow... */
 453   g_warning (""              "YOU ARE USING THE DEVEL BRANCH 1.3.x OF GTK+ WHICH IS CURRENTLY\n"
 454              "                UNDER HEAVY DEVELOPMENT AND FREQUENTLY INTRODUCES INSTABILITIES.\n"
 455              "                if you don't know why you are getting this, you probably want to\n"
 456              "                use the stable branch which can be retrived from\n"
 457              "                ftp://ftp.gtk.org/pub/gtk/v1.2/ or via CVS with\n"
 458              "                cvs checkout -r glib-1-2 glib; cvs checkout -r gtk-1-2 gtk+");
 459 #endif
 460
 461   return TRUE;
 462 }
 463 void
 464 gtk_init (int *argc, char ***argv)
 465 {
 466   if (!gtk_init_check (argc, argv))
 467     {
 468       g_warning ("cannot open display: %s", gdk_get_display ());
 469       exit(1);
 470     }
 471 }
 472
 473 void
 474 gtk_exit (gint errorcode)
 475 {
 476   /* Only if "gtk" has been initialized should we de-initialize.
 477    */
 478   /* de-initialisation is done by the gtk_exit_funct(),
 479    * no need to do this here (Alex J.)
 480    */
 481   gdk_exit(errorcode);
 482 }
 483
 484 gchar*
 485 gtk_set_locale (void)
 486 {
 487   return gdk_set_locale ();
 488 }
 489
 490 void
 491 gtk_main (void)
 492 {
 493   GList *tmp_list;
 494   GList *functions;
 495   GtkInitFunction *init;
 496   GMainLoop *loop;
 497
 498   gtk_main_loop_level++;
 499
 500   loop = g_main_new (TRUE);
 501   main_loops = g_slist_prepend (main_loops, loop);
 502
 503   tmp_list = functions = init_functions;
 504   init_functions = NULL;
 505
 506   while (tmp_list)
 507     {
 508       init = tmp_list->data;
 509       tmp_list = tmp_list->next;
 510
 511       (* init->function) (init->data);
 512       g_free (init);
 513     }
 514   g_list_free (functions);
 515
 516   if (g_main_is_running (main_loops->data))
 517     {
 518       GDK_THREADS_LEAVE ();
 519       g_main_run (loop);
 520       GDK_THREADS_ENTER ();
 521       gdk_flush ();
 522     }
 523
 524   if (quit_functions)
 525     {
 526       GList *reinvoke_list = NULL;
 527       GtkQuitFunction *quitf;
 528
 529       while (quit_functions)
 530         {
 531           quitf = quit_functions->data;
 532
 533           tmp_list = quit_functions;
 534           quit_functions = g_list_remove_link (quit_functions, quit_functions);
 535           g_list_free_1 (tmp_list);
 536
 537           if ((quitf->main_level && quitf->main_level != gtk_main_loop_level) ||
 538               gtk_quit_invoke_function (quitf))
 539             {
 540               reinvoke_list = g_list_prepend (reinvoke_list, quitf);
 541             }
 542           else
 543             {
 544               gtk_quit_destroy (quitf);
 545             }
 546         }
 547       if (reinvoke_list)
 548         {
 549           GList *work;
 550
 551           work = g_list_last (reinvoke_list);
 552           if (quit_functions)
 553             quit_functions->prev = work;
 554           work->next = quit_functions;
 555           quit_functions = work;
 556         }
 557
 558       gdk_flush ();
 559     }
 560
 561   main_loops = g_slist_remove (main_loops, loop);
 562
 563   g_main_destroy (loop);
 564
 565   gtk_main_loop_level--;
 566 }
 567
 568 guint
 569 gtk_main_level (void)
 570 {
 571   return gtk_main_loop_level;
 572 }
 573
 574 void
 575 gtk_main_quit (void)
 576 {
 577   g_return_if_fail (main_loops != NULL);
 578
 579   g_main_quit (main_loops->data);
 580 }
 581
 582 gint
 583 gtk_events_pending (void)
 584 {
 585   gboolean result;
 586
 587   GDK_THREADS_LEAVE ();
 588   result = g_main_pending();
 589   GDK_THREADS_ENTER ();
 590
 591   return result;
 592 }
 593
 594 gint
 595 gtk_main_iteration (void)
 596 {
 597   GDK_THREADS_LEAVE ();
 598   g_main_iteration (TRUE);
 599   GDK_THREADS_ENTER ();
 600
 601   if (main_loops)
 602     return !g_main_is_running (main_loops->data);
 603   else
 604     return TRUE;
 605 }
 606
 607 gint
 608 gtk_main_iteration_do (gboolean blocking)
 609 {
 610   GDK_THREADS_LEAVE ();
 611   g_main_iteration (blocking);
 612   GDK_THREADS_ENTER ();
 613
 614   if (main_loops)
 615     return !g_main_is_running (main_loops->data);
 616   else
 617     return TRUE;
 618 }
 619
 620 void
 621 gtk_main_do_event (GdkEvent *event)
 622 {
 623   GtkWidget *event_widget;
 624   GtkWidget *grab_widget;
 625   GdkEvent *next_event;
 626   GList *tmp_list;
 627
 628   /* If there are any events pending then get the next one.
 629    */
 630   next_event = gdk_event_peek ();
 631
 632   /* Try to compress enter/leave notify events. These event
 633    *  pairs occur when the mouse is dragged quickly across
 634    *  a window with many buttons (or through a menu). Instead
 635    *  of highlighting and de-highlighting each widget that
 636    *  is crossed it is better to simply de-highlight the widget
 637    *  which contained the mouse initially and highlight the
 638    *  widget which ends up containing the mouse.
 639    */
 640   if (next_event)
 641     if (((event->type == GDK_ENTER_NOTIFY) ||
 642          (event->type == GDK_LEAVE_NOTIFY)) &&
 643         ((next_event->type == GDK_ENTER_NOTIFY) ||
 644          (next_event->type == GDK_LEAVE_NOTIFY)) &&
 645         (next_event->type != event->type) &&
 646         (next_event->any.window == event->any.window))
 647       {
 648         /* Throw both the peeked copy and the queued copy away
 649          */
 650         gdk_event_free (next_event);
 651         next_event = gdk_event_get ();
 652         gdk_event_free (next_event);
 653
 654         return;
 655       }
 656
 657   if (next_event)
 658     gdk_event_free (next_event);
 659
 660   /* Find the widget which got the event. We store the widget
 661    *  in the user_data field of GdkWindow's.
 662    *  Ignore the event if we don't have a widget for it, except
 663    *  for GDK_PROPERTY_NOTIFY events which are handled specialy.
 664    *  Though this happens rarely, bogus events can occour
 665    *  for e.g. destroyed GdkWindows.
 666    */
 667   event_widget = gtk_get_event_widget (event);
 668   if (!event_widget)
 669     {
 670       /* To handle selection INCR transactions, we select
 671        * PropertyNotify events on the requestor window and create
 672        * a corresponding (fake) GdkWindow so that events get
 673        * here. There won't be a widget though, so we have to handle
 674            * them specially
 675            */
 676       if (event->type == GDK_PROPERTY_NOTIFY)
 677         gtk_selection_incr_event (event->any.window,
 678                                   &event->property);
 679
 680       return;
 681     }
 682
 683   /* Push the event onto a stack of current events for
 684    * gtk_current_event_get().
 685    */
 686   current_events = g_list_prepend (current_events, event);
 687
 688   /* If there is a grab in effect...
 689    */
 690   if (grabs)
 691     {
 692       grab_widget = grabs->data;
 693
 694       /* If the grab widget is an ancestor of the event widget
 695        *  then we send the event to the original event widget.
 696        *  This is the key to implementing modality.
 697        */
 698       if (GTK_WIDGET_IS_SENSITIVE (event_widget) &&
 699           gtk_widget_is_ancestor (event_widget, grab_widget))
 700         grab_widget = event_widget;
 701     }
 702   else
 703     {
 704       grab_widget = event_widget;
 705     }
 706
 707   /* Not all events get sent to the grabbing widget.
 708    * The delete, destroy, expose, focus change and resize
 709    *  events still get sent to the event widget because
 710    *  1) these events have no meaning for the grabbing widget
 711    *  and 2) redirecting these events to the grabbing widget
 712    *  could cause the display to be messed up.
 713    *
 714    * Drag events are also not redirected, since it isn't
 715    *  clear what the semantics of that would be.
 716    */
 717   switch (event->type)
 718     {
 719     case GDK_NOTHING:
 720       break;
 721
 722     case GDK_DELETE:
 723       gtk_widget_ref (event_widget);
 724       if ((!grabs || gtk_widget_get_toplevel (grabs->data) == event_widget) &&
 725           !gtk_widget_event (event_widget, event))
 726         gtk_widget_destroy (event_widget);
 727       gtk_widget_unref (event_widget);
 728       break;
 729
 730     case GDK_DESTROY:
 731       /* Unexpected GDK_DESTROY from the outside, ignore for
 732        * child windows, handle like a GDK_DELETE for toplevels
 733        */
 734       if (!event_widget->parent)
 735         {
 736           gtk_widget_ref (event_widget);
 737           if (!gtk_widget_event (event_widget, event) &&
 738               !GTK_OBJECT_DESTROYED (event_widget))
 739             gtk_widget_destroy (event_widget);
 740           gtk_widget_unref (event_widget);
 741         }
 742       break;
 743
 744     case GDK_EXPOSE:
 745       if (event->any.window && GTK_WIDGET_DOUBLE_BUFFERED (event_widget))
 746         gdk_window_begin_paint_rect (event->any.window, &event->expose.area);
 747
 748       gtk_widget_event (event_widget, event);
 749
 750       if (event->any.window && GTK_WIDGET_DOUBLE_BUFFERED (event_widget))
 751         gdk_window_end_paint (event->any.window);
 752       break;
 753
 754     case GDK_PROPERTY_NOTIFY:
 755     case GDK_NO_EXPOSE:
 756     case GDK_FOCUS_CHANGE:
 757     case GDK_CONFIGURE:
 758     case GDK_MAP:
 759     case GDK_UNMAP:
 760     case GDK_SELECTION_CLEAR:
 761     case GDK_SELECTION_REQUEST:
 762     case GDK_SELECTION_NOTIFY:
 763     case GDK_CLIENT_EVENT:
 764     case GDK_VISIBILITY_NOTIFY:
 765       gtk_widget_event (event_widget, event);
 766       break;
 767
 768     case GDK_SCROLL:
 769     case GDK_BUTTON_PRESS:
 770     case GDK_2BUTTON_PRESS:
 771     case GDK_3BUTTON_PRESS:
 772       gtk_propagate_event (grab_widget, event);
 773       break;
 774
 775     case GDK_KEY_PRESS:
 776     case GDK_KEY_RELEASE:
 777       if (key_snoopers)
 778         {
 779           if (gtk_invoke_key_snoopers (grab_widget, event))
 780             break;
 781         }
 782       /* else fall through */
 783     case GDK_MOTION_NOTIFY:
 784     case GDK_BUTTON_RELEASE:
 785     case GDK_PROXIMITY_IN:
 786     case GDK_PROXIMITY_OUT:
 787       gtk_propagate_event (grab_widget, event);
 788       break;
 789
 790     case GDK_ENTER_NOTIFY:
 791       if (GTK_WIDGET_IS_SENSITIVE (grab_widget))
 792         {
 793           gtk_widget_event (grab_widget, event);
 794           if (event_widget == grab_widget)
 795             GTK_PRIVATE_SET_FLAG (event_widget, GTK_LEAVE_PENDING);
 796         }
 797       break;
 798
 799     case GDK_LEAVE_NOTIFY:
 800       if (GTK_WIDGET_LEAVE_PENDING (event_widget))
 801         {
 802           GTK_PRIVATE_UNSET_FLAG (event_widget, GTK_LEAVE_PENDING);
 803           gtk_widget_event (event_widget, event);
 804         }
 805       else if (GTK_WIDGET_IS_SENSITIVE (grab_widget))
 806         gtk_widget_event (grab_widget, event);
 807       break;
 808
 809     case GDK_DRAG_STATUS:
 810     case GDK_DROP_FINISHED:
 811       gtk_drag_source_handle_event (event_widget, event);
 812       break;
 813     case GDK_DRAG_ENTER:
 814     case GDK_DRAG_LEAVE:
 815     case GDK_DRAG_MOTION:
 816     case GDK_DROP_START:
 817       gtk_drag_dest_handle_event (event_widget, event);
 818       break;
 819     }
 820
 821   tmp_list = current_events;
 822   current_events = g_list_remove_link (current_events, tmp_list);
 823   g_list_free_1 (tmp_list);
 824 }
 825
 826 gint
 827 gtk_true (void)
 828 {
 829   return TRUE;
 830 }
 831
 832 gint
 833 gtk_false (void)
 834 {
 835   return FALSE;
 836 }
 837
 838 void
 839 gtk_grab_add (GtkWidget *widget)
 840 {
 841   g_return_if_fail (widget != NULL);
 842
 843   if (!GTK_WIDGET_HAS_GRAB (widget))
 844     {
 845       GTK_WIDGET_SET_FLAGS (widget, GTK_HAS_GRAB);
 846
 847       grabs = g_slist_prepend (grabs, widget);
 848       gtk_widget_ref (widget);
 849     }
 850 }
 851
 852 GtkWidget*
 853 gtk_grab_get_current (void)
 854 {
 855   if (grabs)
 856     return GTK_WIDGET (grabs->data);
 857   return NULL;
 858 }
 859
 860 void
 861 gtk_grab_remove (GtkWidget *widget)
 862 {
 863   g_return_if_fail (widget != NULL);
 864
 865   if (GTK_WIDGET_HAS_GRAB (widget))
 866     {
 867       GTK_WIDGET_UNSET_FLAGS (widget, GTK_HAS_GRAB);
 868
 869       grabs = g_slist_remove (grabs, widget);
 870       gtk_widget_unref (widget);
 871     }
 872 }
 873
 874 void
 875 gtk_init_add (GtkFunction function,
 876               gpointer    data)
 877 {
 878   GtkInitFunction *init;
 879
 880   init = g_new (GtkInitFunction, 1);
 881   init->function = function;
 882   init->data = data;
 883
 884   init_functions = g_list_prepend (init_functions, init);
 885 }
 886
 887 guint
 888 gtk_key_snooper_install (GtkKeySnoopFunc snooper,
 889                          gpointer        func_data)
 890 {
 891   GtkKeySnooperData *data;
 892   static guint snooper_id = 1;
 893
 894   g_return_val_if_fail (snooper != NULL, 0);
 895
 896   data = g_new (GtkKeySnooperData, 1);
 897   data->func = snooper;
 898   data->func_data = func_data;
 899   data->id = snooper_id++;
 900   key_snoopers = g_slist_prepend (key_snoopers, data);
 901
 902   return data->id;
 903 }
 904
 905 void
 906 gtk_key_snooper_remove (guint            snooper_id)
 907 {
 908   GtkKeySnooperData *data = NULL;
 909   GSList *slist;
 910
 911   slist = key_snoopers;
 912   while (slist)
 913     {
 914       data = slist->data;
 915       if (data->id == snooper_id)
 916         break;
 917
 918       slist = slist->next;
 919       data = NULL;
 920     }
 921   if (data)
 922     key_snoopers = g_slist_remove (key_snoopers, data);
 923 }
 924
 925 static gint
 926 gtk_invoke_key_snoopers (GtkWidget *grab_widget,
 927                          GdkEvent  *event)
 928 {
 929   GSList *slist;
 930   gint return_val = FALSE;
 931
 932   slist = key_snoopers;
 933   while (slist && !return_val)
 934     {
 935       GtkKeySnooperData *data;
 936
 937       data = slist->data;
 938       slist = slist->next;
 939       return_val = (*data->func) (grab_widget, (GdkEventKey*) event, data->func_data);
 940     }
 941
 942   return return_val;
 943 }
 944
 945 guint
 946 gtk_quit_add_full (guint                main_level,
 947                    GtkFunction          function,
 948                    GtkCallbackMarshal   marshal,
 949                    gpointer             data,
 950                    GtkDestroyNotify     destroy)
 951 {
 952   static guint quit_id = 1;
 953   GtkQuitFunction *quitf;
 954
 955   g_return_val_if_fail ((function != NULL) || (marshal != NULL), 0);
 956
 957   if (!quit_mem_chunk)
 958     quit_mem_chunk = g_mem_chunk_new ("quit mem chunk", sizeof (GtkQuitFunction),
 959                                       512, G_ALLOC_AND_FREE);
 960
 961   quitf = g_chunk_new (GtkQuitFunction, quit_mem_chunk);
 962
 963   quitf->id = quit_id++;
 964   quitf->main_level = main_level;
 965   quitf->function = function;
 966   quitf->marshal = marshal;
 967   quitf->data = data;
 968   quitf->destroy = destroy;
 969
 970   quit_functions = g_list_prepend (quit_functions, quitf);
 971
 972   return quitf->id;
 973 }
 974
 975 static void
 976 gtk_quit_destroy (GtkQuitFunction *quitf)
 977 {
 978   if (quitf->destroy)
 979     quitf->destroy (quitf->data);
 980   g_mem_chunk_free (quit_mem_chunk, quitf);
 981 }
 982
 983 static gint
 984 gtk_quit_destructor (GtkObject **object_p)
 985 {
 986   if (*object_p)
 987     gtk_object_destroy (*object_p);
 988   g_free (object_p);
 989
 990   return FALSE;
 991 }
 992
 993 void
 994 gtk_quit_add_destroy (guint              main_level,
 995                       GtkObject         *object)
 996 {
 997   GtkObject **object_p;
 998
 999   g_return_if_fail (main_level > 0);
1000   g_return_if_fail (object != NULL);
1001   g_return_if_fail (GTK_IS_OBJECT (object));
1002
1003   object_p = g_new (GtkObject*, 1);
1004   *object_p = object;
1005   gtk_signal_connect (object,
1006                       "destroy",
1007                       GTK_SIGNAL_FUNC (gtk_widget_destroyed),
1008                       object_p);
1009   gtk_quit_add (main_level, (GtkFunction) gtk_quit_destructor, object_p);
1010 }
1011
1012 guint
1013 gtk_quit_add (guint       main_level,
1014               GtkFunction function,
1015               gpointer    data)
1016 {
1017   return gtk_quit_add_full (main_level, function, NULL, data, NULL);
1018 }
1019
1020 void
1021 gtk_quit_remove (guint id)
1022 {
1023   GtkQuitFunction *quitf;
1024   GList *tmp_list;
1025
1026   tmp_list = quit_functions;
1027   while (tmp_list)
1028     {
1029       quitf = tmp_list->data;
1030
1031       if (quitf->id == id)
1032         {
1033           quit_functions = g_list_remove_link (quit_functions, tmp_list);
1034           g_list_free (tmp_list);
1035           gtk_quit_destroy (quitf);
1036
1037           return;
1038         }
1039
1040       tmp_list = tmp_list->next;
1041     }
1042 }
1043
1044 void
1045 gtk_quit_remove_by_data (gpointer data)
1046 {
1047   GtkQuitFunction *quitf;
1048   GList *tmp_list;
1049
1050   tmp_list = quit_functions;
1051   while (tmp_list)
1052     {
1053       quitf = tmp_list->data;
1054
1055       if (quitf->data == data)
1056         {
1057           quit_functions = g_list_remove_link (quit_functions, tmp_list);
1058           g_list_free (tmp_list);
1059           gtk_quit_destroy (quitf);
1060
1061           return;
1062         }
1063
1064       tmp_list = tmp_list->next;
1065     }
1066 }
1067
1068 guint
1069 gtk_timeout_add_full (guint32            interval,
1070                       GtkFunction        function,
1071                       GtkCallbackMarshal marshal,
1072                       gpointer           data,
1073                       GtkDestroyNotify   destroy)
1074 {
1075   if (marshal)
1076     {
1077       GtkClosure *closure;
1078
1079       closure = g_new (GtkClosure, 1);
1080       closure->marshal = marshal;
1081       closure->data = data;
1082       closure->destroy = destroy;
1083
1084       return g_timeout_add_full (0, interval,
1085                                  gtk_invoke_idle_timeout,
1086                                  closure,
1087                                  gtk_destroy_closure);
1088     }
1089   else
1090     return g_timeout_add_full (0, interval, function, data, destroy);
1091 }
1092
1093 guint
1094 gtk_timeout_add (guint32     interval,
1095                  GtkFunction function,
1096                  gpointer    data)
1097 {
1098   return g_timeout_add_full (0, interval, function, data, NULL);
1099 }
1100
1101 void
1102 gtk_timeout_remove (guint tag)
1103 {
1104   g_source_remove (tag);
1105 }
1106
1107 guint
1108 gtk_idle_add_full (gint                 priority,
1109                    GtkFunction          function,
1110                    GtkCallbackMarshal   marshal,
1111                    gpointer             data,
1112                    GtkDestroyNotify     destroy)
1113 {
1114   if (marshal)
1115     {
1116       GtkClosure *closure;
1117
1118       closure = g_new (GtkClosure, 1);
1119       closure->marshal = marshal;
1120       closure->data = data;
1121       closure->destroy = destroy;
1122
1123       return g_idle_add_full (priority,
1124                               gtk_invoke_idle_timeout,
1125                               closure,
1126                               gtk_destroy_closure);
1127     }
1128   else
1129     return g_idle_add_full (priority, function, data, destroy);
1130 }
1131
1132 guint
1133 gtk_idle_add (GtkFunction function,
1134               gpointer    data)
1135 {
1136   return g_idle_add_full (GTK_PRIORITY_DEFAULT, function, data, NULL);
1137 }
1138
1139 guint
1140 gtk_idle_add_priority   (gint               priority,
1141                          GtkFunction        function,
1142                          gpointer           data)
1143 {
1144   return g_idle_add_full (priority, function, data, NULL);
1145 }
1146
1147 void
1148 gtk_idle_remove (guint tag)
1149 {
1150   g_source_remove (tag);
1151 }
1152
1153 void
1154 gtk_idle_remove_by_data (gpointer data)
1155 {
1156   if (!g_idle_remove_by_data (data))
1157     g_warning ("gtk_idle_remove_by_data(%p): no such idle", data);
1158 }
1159
1160 guint
1161 gtk_input_add_full (gint                source,
1162                     GdkInputCondition   condition,
1163                     GdkInputFunction    function,
1164                     GtkCallbackMarshal  marshal,
1165                     gpointer            data,
1166                     GtkDestroyNotify    destroy)
1167 {
1168   if (marshal)
1169     {
1170       GtkClosure *closure;
1171
1172       closure = g_new (GtkClosure, 1);
1173       closure->marshal = marshal;
1174       closure->data = data;
1175       closure->destroy = destroy;
1176
1177       return gdk_input_add_full (source,
1178                                  condition,
1179                                  (GdkInputFunction) gtk_invoke_input,
1180                                  closure,
1181                                  (GdkDestroyNotify) gtk_destroy_closure);
1182     }
1183   else
1184     return gdk_input_add_full (source, condition, function, data, destroy);
1185 }
1186
1187 void
1188 gtk_input_remove (guint tag)
1189 {
1190   g_source_remove (tag);
1191 }
1192
1193 static void
1194 gtk_destroy_closure (gpointer data)
1195 {
1196   GtkClosure *closure = data;
1197
1198   if (closure->destroy)
1199     (closure->destroy) (closure->data);
1200   g_free (closure);
1201 }
1202
1203 static gboolean
1204 gtk_invoke_idle_timeout (gpointer data)
1205 {
1206   GtkClosure *closure = data;
1207
1208   GtkArg args[1];
1209   gint ret_val = FALSE;
1210   args[0].name = NULL;
1211   args[0].type = GTK_TYPE_BOOL;
1212   args[0].d.pointer_data = &ret_val;
1213   closure->marshal (NULL, closure->data,  0, args);
1214   return ret_val;
1215 }
1216
1217 static void
1218 gtk_invoke_input (gpointer          data,
1219                   gint              source,
1220                   GdkInputCondition condition)
1221 {
1222   GtkClosure *closure = data;
1223
1224   GtkArg args[3];
1225   args[0].type = GTK_TYPE_INT;
1226   args[0].name = NULL;
1227   GTK_VALUE_INT(args[0]) = source;
1228   args[1].type = GTK_TYPE_GDK_INPUT_CONDITION;
1229   args[1].name = NULL;
1230   GTK_VALUE_FLAGS(args[1]) = condition;
1231   args[2].type = GTK_TYPE_NONE;
1232   args[2].name = NULL;
1233
1234   closure->marshal (NULL, closure->data, 2, args);
1235 }
1236
1237 GdkEvent*
1238 gtk_get_current_event (void)
1239 {
1240   if (current_events)
1241     return gdk_event_copy ((GdkEvent *) current_events->data);
1242   else
1243     return NULL;
1244 }
1245
1246 GtkWidget*
1247 gtk_get_event_widget (GdkEvent *event)
1248 {
1249   GtkWidget *widget;
1250
1251   widget = NULL;
1252   if (event && event->any.window)
1253     gdk_window_get_user_data (event->any.window, (void**) &widget);
1254
1255   return widget;
1256 }
1257
1258 static void
1259 gtk_exit_func (void)
1260 {
1261   if (gtk_initialized)
1262     {
1263       gtk_initialized = FALSE;
1264       gtk_preview_uninit ();
1265     }
1266 }
1267
1268
1269 static gint
1270 gtk_quit_invoke_function (GtkQuitFunction *quitf)
1271 {
1272   if (!quitf->marshal)
1273     return quitf->function (quitf->data);
1274   else
1275     {
1276       GtkArg args[1];
1277       gint ret_val = FALSE;
1278
1279       args[0].name = NULL;
1280       args[0].type = GTK_TYPE_BOOL;
1281       args[0].d.pointer_data = &ret_val;
1282       ((GtkCallbackMarshal) quitf->marshal) (NULL,
1283                                              quitf->data,
1284                                              0, args);
1285       return ret_val;
1286     }
1287 }
1288
1289 void
1290 gtk_propagate_event (GtkWidget *widget,
1291                      GdkEvent  *event)
1292 {
1293   gint handled_event;
1294
1295   g_return_if_fail (widget != NULL);
1296   g_return_if_fail (GTK_IS_WIDGET (widget));
1297   g_return_if_fail (event != NULL);
1298
1299   handled_event = FALSE;
1300
1301   if ((event->type == GDK_KEY_PRESS) ||
1302       (event->type == GDK_KEY_RELEASE))
1303     {
1304       /* Only send key events within Window widgets to the Window
1305        *  The Window widget will in turn pass the
1306        *  key event on to the currently focused widget
1307        *  for that window.
1308        */
1309       GtkWidget *window;
1310
1311       window = gtk_widget_get_ancestor (widget, GTK_TYPE_WINDOW);
1312       if (window)
1313         {
1314           if (GTK_WIDGET_IS_SENSITIVE (window))
1315             gtk_widget_event (window, event);
1316
1317           handled_event = TRUE; /* don't send to widget */
1318         }
1319     }
1320
1321   /* Other events get propagated up the widget tree
1322    *  so that parents can see the button and motion
1323    *  events of the children.
1324    */
1325   while (!handled_event && widget)
1326     {
1327       GtkWidget *tmp;
1328
1329       gtk_widget_ref (widget);
1330       handled_event = !GTK_WIDGET_IS_SENSITIVE (widget) || gtk_widget_event (widget, event);
1331       tmp = widget->parent;
1332       gtk_widget_unref (widget);
1333       widget  = tmp;
1334     }
1335 }
1336
1337 #if 0
1338 static void
1339 gtk_error (gchar *str)
1340 {
1341   gtk_print (str);
1342 }
1343
1344 static void
1345 gtk_warning (gchar *str)
1346 {
1347   gtk_print (str);
1348 }
1349
1350 static void
1351 gtk_message (gchar *str)
1352 {
1353   gtk_print (str);
1354 }
1355
1356 static void
1357 gtk_print (gchar *str)
1358 {
1359   static GtkWidget *window = NULL;
1360   static GtkWidget *text;
1361   static int level = 0;
1362   GtkWidget *box1;
1363   GtkWidget *box2;
1364   GtkWidget *table;
1365   GtkWidget *hscrollbar;
1366   GtkWidget *vscrollbar;
1367   GtkWidget *separator;
1368   GtkWidget *button;
1369
1370   if (level > 0)
1371     {
1372       fputs (str, stdout);
1373       fflush (stdout);
1374       return;
1375     }
1376
1377   if (!window)
1378     {
1379       window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
1380
1381       gtk_signal_connect (GTK_OBJECT (window), "destroy",
1382                           (GtkSignalFunc) gtk_widget_destroyed,
1383                           &window);
1384
1385       gtk_window_set_title (GTK_WINDOW (window), "Messages");
1386
1387       box1 = gtk_vbox_new (FALSE, 0);
1388       gtk_container_add (GTK_CONTAINER (window), box1);
1389       gtk_widget_show (box1);
1390
1391
1392       box2 = gtk_vbox_new (FALSE, 10);
1393       gtk_container_set_border_width (GTK_CONTAINER (box2), 10);
1394       gtk_box_pack_start (GTK_BOX (box1), box2, TRUE, TRUE, 0);
1395       gtk_widget_show (box2);
1396
1397
1398       table = gtk_table_new (2, 2, FALSE);
1399       gtk_table_set_row_spacing (GTK_TABLE (table), 0, 2);
1400       gtk_table_set_col_spacing (GTK_TABLE (table), 0, 2);
1401       gtk_box_pack_start (GTK_BOX (box2), table, TRUE, TRUE, 0);
1402       gtk_widget_show (table);
1403
1404       text = gtk_text_new (NULL, NULL);
1405       gtk_text_set_editable (GTK_TEXT (text), FALSE);
1406       gtk_table_attach_defaults (GTK_TABLE (table), text, 0, 1, 0, 1);
1407       gtk_widget_show (text);
1408       gtk_widget_realize (text);
1409
1410       hscrollbar = gtk_hscrollbar_new (GTK_TEXT (text)->hadj);
1411       gtk_table_attach (GTK_TABLE (table), hscrollbar, 0, 1, 1, 2,
1412                         GTK_EXPAND | GTK_FILL, GTK_FILL, 0, 0);
1413       gtk_widget_show (hscrollbar);
1414
1415       vscrollbar = gtk_vscrollbar_new (GTK_TEXT (text)->vadj);
1416       gtk_table_attach (GTK_TABLE (table), vscrollbar, 1, 2, 0, 1,
1417                         GTK_FILL, GTK_EXPAND | GTK_FILL, 0, 0);
1418       gtk_widget_show (vscrollbar);
1419
1420       separator = gtk_hseparator_new ();
1421       gtk_box_pack_start (GTK_BOX (box1), separator, FALSE, TRUE, 0);
1422       gtk_widget_show (separator);
1423
1424
1425       box2 = gtk_vbox_new (FALSE, 10);
1426       gtk_container_set_border_width (GTK_CONTAINER (box2), 10);
1427       gtk_box_pack_start (GTK_BOX (box1), box2, FALSE, TRUE, 0);
1428       gtk_widget_show (box2);
1429
1430
1431       button = gtk_button_new_with_label ("close");
1432       gtk_signal_connect_object (GTK_OBJECT (button), "clicked",
1433                                  (GtkSignalFunc) gtk_widget_hide,
1434                                  GTK_OBJECT (window));
1435       gtk_box_pack_start (GTK_BOX (box2), button, TRUE, TRUE, 0);
1436       GTK_WIDGET_SET_FLAGS (button, GTK_CAN_DEFAULT);
1437       gtk_widget_grab_default (button);
1438       gtk_widget_show (button);
1439     }
1440
1441   level += 1;
1442   gtk_text_insert (GTK_TEXT (text), NULL, NULL, NULL, str, -1);
1443   level -= 1;
1444
1445   if (!GTK_WIDGET_VISIBLE (window))
1446     gtk_widget_show (window);
1447 }
1448 #endif