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 };
 155
 156 static const guint gtk_ndebug_keys = sizeof (gtk_debug_keys) / sizeof (GDebugKey);
 157
 158 #endif /* G_ENABLE_DEBUG */
 159
 160 gchar*
 161 gtk_check_version (guint required_major,
 162                    guint required_minor,
 163                    guint required_micro)
 164 {
 165   if (required_major > GTK_MAJOR_VERSION)
 166     return "Gtk+ version too old (major mismatch)";
 167   if (required_major < GTK_MAJOR_VERSION)
 168     return "Gtk+ version too new (major mismatch)";
 169   if (required_minor > GTK_MINOR_VERSION)
 170     return "Gtk+ version too old (minor mismatch)";
 171   if (required_minor < GTK_MINOR_VERSION)
 172     return "Gtk+ version too new (minor mismatch)";
 173   if (required_micro < GTK_MICRO_VERSION - GTK_BINARY_AGE)
 174     return "Gtk+ version too new (micro mismatch)";
 175   if (required_micro > GTK_MICRO_VERSION)
 176     return "Gtk+ version too old (micro mismatch)";
 177   return NULL;
 178 }
 179
 180 #ifdef __EMX__
 181 static gchar *add_dll_suffix(gchar *module_name)
 182 {
 183     gchar *suffix = strrchr(module_name, '.');
 184
 185     if (!suffix || stricmp(suffix, ".dll"))
 186     {
 187         gchar *old = module_name;
 188
 189         module_name = g_strconcat (module_name, ".dll", NULL);
 190         g_free (old);
 191     }
 192     return (module_name);
 193 }
 194 #endif
 195
 196 gboolean
 197 gtk_init_check (int      *argc,
 198                 char   ***argv)
 199 {
 200   extern void gtk_object_post_arg_parsing_init (void);
 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_object_post_arg_parsing_init ();
 426   gtk_signal_init ();
 427   gtk_rc_init ();
 428
 429
 430   /* Register an exit function to make sure we are able to cleanup.
 431    */
 432   g_atexit (gtk_exit_func);
 433
 434   /* Set the 'initialized' flag.
 435    */
 436   gtk_initialized = TRUE;
 437
 438   /* initialize gtk modules
 439    */
 440   for (slist = gtk_modules; slist; slist = slist->next)
 441     {
 442       if (slist->data)
 443         {
 444           GtkModuleInitFunc modinit;
 445
 446           modinit = slist->data;
 447           modinit (argc, argv);
 448         }
 449     }
 450   g_slist_free (gtk_modules);
 451
 452 #ifndef G_OS_WIN32
 453   /* No use warning on Win32, there aren't any non-devel versions anyhow... */
 454   g_warning (""              "YOU ARE USING THE DEVEL BRANCH 1.3.x OF GTK+ WHICH IS CURRENTLY\n"
 455              "                UNDER HEAVY DEVELOPMENT AND FREQUENTLY INTRODUCES INSTABILITIES.\n"
 456              "                if you don't know why you are getting this, you probably want to\n"
 457              "                use the stable branch which can be retrived from\n"
 458              "                ftp://ftp.gtk.org/pub/gtk/v1.2/ or via CVS with\n"
 459              "                cvs checkout -r glib-1-2 glib; cvs checkout -r gtk-1-2 gtk+");
 460 #endif
 461
 462   return TRUE;
 463 }
 464 void
 465 gtk_init (int *argc, char ***argv)
 466 {
 467   if (!gtk_init_check (argc, argv))
 468     {
 469       g_warning ("cannot open display: %s", gdk_get_display ());
 470       exit(1);
 471     }
 472 }
 473
 474 void
 475 gtk_exit (gint errorcode)
 476 {
 477   /* Only if "gtk" has been initialized should we de-initialize.
 478    */
 479   /* de-initialisation is done by the gtk_exit_funct(),
 480    * no need to do this here (Alex J.)
 481    */
 482   gdk_exit(errorcode);
 483 }
 484
 485 gchar*
 486 gtk_set_locale (void)
 487 {
 488   return gdk_set_locale ();
 489 }
 490
 491 void
 492 gtk_main (void)
 493 {
 494   GList *tmp_list;
 495   GList *functions;
 496   GtkInitFunction *init;
 497   GMainLoop *loop;
 498
 499   gtk_main_loop_level++;
 500
 501   loop = g_main_new (TRUE);
 502   main_loops = g_slist_prepend (main_loops, loop);
 503
 504   tmp_list = functions = init_functions;
 505   init_functions = NULL;
 506
 507   while (tmp_list)
 508     {
 509       init = tmp_list->data;
 510       tmp_list = tmp_list->next;
 511
 512       (* init->function) (init->data);
 513       g_free (init);
 514     }
 515   g_list_free (functions);
 516
 517   if (g_main_is_running (main_loops->data))
 518     {
 519       GDK_THREADS_LEAVE ();
 520       g_main_run (loop);
 521       GDK_THREADS_ENTER ();
 522       gdk_flush ();
 523     }
 524
 525   if (quit_functions)
 526     {
 527       GList *reinvoke_list = NULL;
 528       GtkQuitFunction *quitf;
 529
 530       while (quit_functions)
 531         {
 532           quitf = quit_functions->data;
 533
 534           tmp_list = quit_functions;
 535           quit_functions = g_list_remove_link (quit_functions, quit_functions);
 536           g_list_free_1 (tmp_list);
 537
 538           if ((quitf->main_level && quitf->main_level != gtk_main_loop_level) ||
 539               gtk_quit_invoke_function (quitf))
 540             {
 541               reinvoke_list = g_list_prepend (reinvoke_list, quitf);
 542             }
 543           else
 544             {
 545               gtk_quit_destroy (quitf);
 546             }
 547         }
 548       if (reinvoke_list)
 549         {
 550           GList *work;
 551
 552           work = g_list_last (reinvoke_list);
 553           if (quit_functions)
 554             quit_functions->prev = work;
 555           work->next = quit_functions;
 556           quit_functions = work;
 557         }
 558
 559       gdk_flush ();
 560     }
 561
 562   main_loops = g_slist_remove (main_loops, loop);
 563
 564   g_main_destroy (loop);
 565
 566   gtk_main_loop_level--;
 567 }
 568
 569 guint
 570 gtk_main_level (void)
 571 {
 572   return gtk_main_loop_level;
 573 }
 574
 575 void
 576 gtk_main_quit (void)
 577 {
 578   g_return_if_fail (main_loops != NULL);
 579
 580   g_main_quit (main_loops->data);
 581 }
 582
 583 gint
 584 gtk_events_pending (void)
 585 {
 586   gboolean result;
 587
 588   GDK_THREADS_LEAVE ();
 589   result = g_main_pending();
 590   GDK_THREADS_ENTER ();
 591
 592   return result;
 593 }
 594
 595 gint
 596 gtk_main_iteration (void)
 597 {
 598   GDK_THREADS_LEAVE ();
 599   g_main_iteration (TRUE);
 600   GDK_THREADS_ENTER ();
 601
 602   if (main_loops)
 603     return !g_main_is_running (main_loops->data);
 604   else
 605     return TRUE;
 606 }
 607
 608 gint
 609 gtk_main_iteration_do (gboolean blocking)
 610 {
 611   GDK_THREADS_LEAVE ();
 612   g_main_iteration (blocking);
 613   GDK_THREADS_ENTER ();
 614
 615   if (main_loops)
 616     return !g_main_is_running (main_loops->data);
 617   else
 618     return TRUE;
 619 }
 620
 621 void
 622 gtk_main_do_event (GdkEvent *event)
 623 {
 624   GtkWidget *event_widget;
 625   GtkWidget *grab_widget;
 626   GdkEvent *next_event;
 627   GList *tmp_list;
 628
 629   /* If there are any events pending then get the next one.
 630    */
 631   next_event = gdk_event_peek ();
 632
 633   /* Try to compress enter/leave notify events. These event
 634    *  pairs occur when the mouse is dragged quickly across
 635    *  a window with many buttons (or through a menu). Instead
 636    *  of highlighting and de-highlighting each widget that
 637    *  is crossed it is better to simply de-highlight the widget
 638    *  which contained the mouse initially and highlight the
 639    *  widget which ends up containing the mouse.
 640    */
 641   if (next_event)
 642     if (((event->type == GDK_ENTER_NOTIFY) ||
 643          (event->type == GDK_LEAVE_NOTIFY)) &&
 644         ((next_event->type == GDK_ENTER_NOTIFY) ||
 645          (next_event->type == GDK_LEAVE_NOTIFY)) &&
 646         (next_event->type != event->type) &&
 647         (next_event->any.window == event->any.window))
 648       {
 649         /* Throw both the peeked copy and the queued copy away
 650          */
 651         gdk_event_free (next_event);
 652         next_event = gdk_event_get ();
 653         gdk_event_free (next_event);
 654
 655         return;
 656       }
 657
 658   if (next_event)
 659     gdk_event_free (next_event);
 660
 661   /* Find the widget which got the event. We store the widget
 662    *  in the user_data field of GdkWindow's.
 663    *  Ignore the event if we don't have a widget for it, except
 664    *  for GDK_PROPERTY_NOTIFY events which are handled specialy.
 665    *  Though this happens rarely, bogus events can occour
 666    *  for e.g. destroyed GdkWindows.
 667    */
 668   event_widget = gtk_get_event_widget (event);
 669   if (!event_widget)
 670     {
 671       /* To handle selection INCR transactions, we select
 672        * PropertyNotify events on the requestor window and create
 673        * a corresponding (fake) GdkWindow so that events get
 674        * here. There won't be a widget though, so we have to handle
 675            * them specially
 676            */
 677       if (event->type == GDK_PROPERTY_NOTIFY)
 678         gtk_selection_incr_event (event->any.window,
 679                                   &event->property);
 680
 681       return;
 682     }
 683
 684   /* Push the event onto a stack of current events for
 685    * gtk_current_event_get().
 686    */
 687   current_events = g_list_prepend (current_events, event);
 688
 689   /* If there is a grab in effect...
 690    */
 691   if (grabs)
 692     {
 693       grab_widget = grabs->data;
 694
 695       /* If the grab widget is an ancestor of the event widget
 696        *  then we send the event to the original event widget.
 697        *  This is the key to implementing modality.
 698        */
 699       if (GTK_WIDGET_IS_SENSITIVE (event_widget) &&
 700           gtk_widget_is_ancestor (event_widget, grab_widget))
 701         grab_widget = event_widget;
 702     }
 703   else
 704     {
 705       grab_widget = event_widget;
 706     }
 707
 708   /* Not all events get sent to the grabbing widget.
 709    * The delete, destroy, expose, focus change and resize
 710    *  events still get sent to the event widget because
 711    *  1) these events have no meaning for the grabbing widget
 712    *  and 2) redirecting these events to the grabbing widget
 713    *  could cause the display to be messed up.
 714    *
 715    * Drag events are also not redirected, since it isn't
 716    *  clear what the semantics of that would be.
 717    */
 718   switch (event->type)
 719     {
 720     case GDK_NOTHING:
 721       break;
 722
 723     case GDK_DELETE:
 724       gtk_widget_ref (event_widget);
 725       if ((!grabs || gtk_widget_get_toplevel (grabs->data) == event_widget) &&
 726           !gtk_widget_event (event_widget, event))
 727         gtk_widget_destroy (event_widget);
 728       gtk_widget_unref (event_widget);
 729       break;
 730
 731     case GDK_DESTROY:
 732       /* Unexpected GDK_DESTROY from the outside, ignore for
 733        * child windows, handle like a GDK_DELETE for toplevels
 734        */
 735       if (!event_widget->parent)
 736         {
 737           gtk_widget_ref (event_widget);
 738           if (!gtk_widget_event (event_widget, event) &&
 739               !GTK_OBJECT_DESTROYED (event_widget))
 740             gtk_widget_destroy (event_widget);
 741           gtk_widget_unref (event_widget);
 742         }
 743       break;
 744
 745     case GDK_PROPERTY_NOTIFY:
 746     case GDK_EXPOSE:
 747     case GDK_NO_EXPOSE:
 748     case GDK_FOCUS_CHANGE:
 749     case GDK_CONFIGURE:
 750     case GDK_MAP:
 751     case GDK_UNMAP:
 752     case GDK_SELECTION_CLEAR:
 753     case GDK_SELECTION_REQUEST:
 754     case GDK_SELECTION_NOTIFY:
 755     case GDK_CLIENT_EVENT:
 756     case GDK_VISIBILITY_NOTIFY:
 757       gtk_widget_event (event_widget, event);
 758       break;
 759
 760     case GDK_SCROLL:
 761     case GDK_BUTTON_PRESS:
 762     case GDK_2BUTTON_PRESS:
 763     case GDK_3BUTTON_PRESS:
 764       gtk_propagate_event (grab_widget, event);
 765       break;
 766
 767     case GDK_KEY_PRESS:
 768     case GDK_KEY_RELEASE:
 769       if (key_snoopers)
 770         {
 771           if (gtk_invoke_key_snoopers (grab_widget, event))
 772             break;
 773         }
 774       /* else fall through */
 775     case GDK_MOTION_NOTIFY:
 776     case GDK_BUTTON_RELEASE:
 777     case GDK_PROXIMITY_IN:
 778     case GDK_PROXIMITY_OUT:
 779       gtk_propagate_event (grab_widget, event);
 780       break;
 781
 782     case GDK_ENTER_NOTIFY:
 783       if (GTK_WIDGET_IS_SENSITIVE (grab_widget))
 784         {
 785           gtk_widget_event (grab_widget, event);
 786           if (event_widget == grab_widget)
 787             GTK_PRIVATE_SET_FLAG (event_widget, GTK_LEAVE_PENDING);
 788         }
 789       break;
 790
 791     case GDK_LEAVE_NOTIFY:
 792       if (GTK_WIDGET_LEAVE_PENDING (event_widget))
 793         {
 794           GTK_PRIVATE_UNSET_FLAG (event_widget, GTK_LEAVE_PENDING);
 795           gtk_widget_event (event_widget, event);
 796         }
 797       else if (GTK_WIDGET_IS_SENSITIVE (grab_widget))
 798         gtk_widget_event (grab_widget, event);
 799       break;
 800
 801     case GDK_DRAG_STATUS:
 802     case GDK_DROP_FINISHED:
 803       gtk_drag_source_handle_event (event_widget, event);
 804       break;
 805     case GDK_DRAG_ENTER:
 806     case GDK_DRAG_LEAVE:
 807     case GDK_DRAG_MOTION:
 808     case GDK_DROP_START:
 809       gtk_drag_dest_handle_event (event_widget, event);
 810       break;
 811     }
 812
 813   tmp_list = current_events;
 814   current_events = g_list_remove_link (current_events, tmp_list);
 815   g_list_free_1 (tmp_list);
 816 }
 817
 818 gint
 819 gtk_true (void)
 820 {
 821   return TRUE;
 822 }
 823
 824 gint
 825 gtk_false (void)
 826 {
 827   return FALSE;
 828 }
 829
 830 void
 831 gtk_grab_add (GtkWidget *widget)
 832 {
 833   g_return_if_fail (widget != NULL);
 834
 835   if (!GTK_WIDGET_HAS_GRAB (widget))
 836     {
 837       GTK_WIDGET_SET_FLAGS (widget, GTK_HAS_GRAB);
 838
 839       grabs = g_slist_prepend (grabs, widget);
 840       gtk_widget_ref (widget);
 841     }
 842 }
 843
 844 GtkWidget*
 845 gtk_grab_get_current (void)
 846 {
 847   if (grabs)
 848     return GTK_WIDGET (grabs->data);
 849   return NULL;
 850 }
 851
 852 void
 853 gtk_grab_remove (GtkWidget *widget)
 854 {
 855   g_return_if_fail (widget != NULL);
 856
 857   if (GTK_WIDGET_HAS_GRAB (widget))
 858     {
 859       GTK_WIDGET_UNSET_FLAGS (widget, GTK_HAS_GRAB);
 860
 861       grabs = g_slist_remove (grabs, widget);
 862       gtk_widget_unref (widget);
 863     }
 864 }
 865
 866 void
 867 gtk_init_add (GtkFunction function,
 868               gpointer    data)
 869 {
 870   GtkInitFunction *init;
 871
 872   init = g_new (GtkInitFunction, 1);
 873   init->function = function;
 874   init->data = data;
 875
 876   init_functions = g_list_prepend (init_functions, init);
 877 }
 878
 879 guint
 880 gtk_key_snooper_install (GtkKeySnoopFunc snooper,
 881                          gpointer        func_data)
 882 {
 883   GtkKeySnooperData *data;
 884   static guint snooper_id = 1;
 885
 886   g_return_val_if_fail (snooper != NULL, 0);
 887
 888   data = g_new (GtkKeySnooperData, 1);
 889   data->func = snooper;
 890   data->func_data = func_data;
 891   data->id = snooper_id++;
 892   key_snoopers = g_slist_prepend (key_snoopers, data);
 893
 894   return data->id;
 895 }
 896
 897 void
 898 gtk_key_snooper_remove (guint            snooper_id)
 899 {
 900   GtkKeySnooperData *data = NULL;
 901   GSList *slist;
 902
 903   slist = key_snoopers;
 904   while (slist)
 905     {
 906       data = slist->data;
 907       if (data->id == snooper_id)
 908         break;
 909
 910       slist = slist->next;
 911       data = NULL;
 912     }
 913   if (data)
 914     key_snoopers = g_slist_remove (key_snoopers, data);
 915 }
 916
 917 static gint
 918 gtk_invoke_key_snoopers (GtkWidget *grab_widget,
 919                          GdkEvent  *event)
 920 {
 921   GSList *slist;
 922   gint return_val = FALSE;
 923
 924   slist = key_snoopers;
 925   while (slist && !return_val)
 926     {
 927       GtkKeySnooperData *data;
 928
 929       data = slist->data;
 930       slist = slist->next;
 931       return_val = (*data->func) (grab_widget, (GdkEventKey*) event, data->func_data);
 932     }
 933
 934   return return_val;
 935 }
 936
 937 guint
 938 gtk_quit_add_full (guint                main_level,
 939                    GtkFunction          function,
 940                    GtkCallbackMarshal   marshal,
 941                    gpointer             data,
 942                    GtkDestroyNotify     destroy)
 943 {
 944   static guint quit_id = 1;
 945   GtkQuitFunction *quitf;
 946
 947   g_return_val_if_fail ((function != NULL) || (marshal != NULL), 0);
 948
 949   if (!quit_mem_chunk)
 950     quit_mem_chunk = g_mem_chunk_new ("quit mem chunk", sizeof (GtkQuitFunction),
 951                                       512, G_ALLOC_AND_FREE);
 952
 953   quitf = g_chunk_new (GtkQuitFunction, quit_mem_chunk);
 954
 955   quitf->id = quit_id++;
 956   quitf->main_level = main_level;
 957   quitf->function = function;
 958   quitf->marshal = marshal;
 959   quitf->data = data;
 960   quitf->destroy = destroy;
 961
 962   quit_functions = g_list_prepend (quit_functions, quitf);
 963
 964   return quitf->id;
 965 }
 966
 967 static void
 968 gtk_quit_destroy (GtkQuitFunction *quitf)
 969 {
 970   if (quitf->destroy)
 971     quitf->destroy (quitf->data);
 972   g_mem_chunk_free (quit_mem_chunk, quitf);
 973 }
 974
 975 static gint
 976 gtk_quit_destructor (GtkObject **object_p)
 977 {
 978   if (*object_p)
 979     gtk_object_destroy (*object_p);
 980   g_free (object_p);
 981
 982   return FALSE;
 983 }
 984
 985 void
 986 gtk_quit_add_destroy (guint              main_level,
 987                       GtkObject         *object)
 988 {
 989   GtkObject **object_p;
 990
 991   g_return_if_fail (main_level > 0);
 992   g_return_if_fail (object != NULL);
 993   g_return_if_fail (GTK_IS_OBJECT (object));
 994
 995   object_p = g_new (GtkObject*, 1);
 996   *object_p = object;
 997   gtk_signal_connect (object,
 998                       "destroy",
 999                       GTK_SIGNAL_FUNC (gtk_widget_destroyed),
1000                       object_p);
1001   gtk_quit_add (main_level, (GtkFunction) gtk_quit_destructor, object_p);
1002 }
1003
1004 guint
1005 gtk_quit_add (guint       main_level,
1006               GtkFunction function,
1007               gpointer    data)
1008 {
1009   return gtk_quit_add_full (main_level, function, NULL, data, NULL);
1010 }
1011
1012 void
1013 gtk_quit_remove (guint id)
1014 {
1015   GtkQuitFunction *quitf;
1016   GList *tmp_list;
1017
1018   tmp_list = quit_functions;
1019   while (tmp_list)
1020     {
1021       quitf = tmp_list->data;
1022
1023       if (quitf->id == id)
1024         {
1025           quit_functions = g_list_remove_link (quit_functions, tmp_list);
1026           g_list_free (tmp_list);
1027           gtk_quit_destroy (quitf);
1028
1029           return;
1030         }
1031
1032       tmp_list = tmp_list->next;
1033     }
1034 }
1035
1036 void
1037 gtk_quit_remove_by_data (gpointer data)
1038 {
1039   GtkQuitFunction *quitf;
1040   GList *tmp_list;
1041
1042   tmp_list = quit_functions;
1043   while (tmp_list)
1044     {
1045       quitf = tmp_list->data;
1046
1047       if (quitf->data == data)
1048         {
1049           quit_functions = g_list_remove_link (quit_functions, tmp_list);
1050           g_list_free (tmp_list);
1051           gtk_quit_destroy (quitf);
1052
1053           return;
1054         }
1055
1056       tmp_list = tmp_list->next;
1057     }
1058 }
1059
1060 guint
1061 gtk_timeout_add_full (guint32            interval,
1062                       GtkFunction        function,
1063                       GtkCallbackMarshal marshal,
1064                       gpointer           data,
1065                       GtkDestroyNotify   destroy)
1066 {
1067   if (marshal)
1068     {
1069       GtkClosure *closure;
1070
1071       closure = g_new (GtkClosure, 1);
1072       closure->marshal = marshal;
1073       closure->data = data;
1074       closure->destroy = destroy;
1075
1076       return g_timeout_add_full (0, interval,
1077                                  gtk_invoke_idle_timeout,
1078                                  closure,
1079                                  gtk_destroy_closure);
1080     }
1081   else
1082     return g_timeout_add_full (0, interval, function, data, destroy);
1083 }
1084
1085 guint
1086 gtk_timeout_add (guint32     interval,
1087                  GtkFunction function,
1088                  gpointer    data)
1089 {
1090   return g_timeout_add_full (0, interval, function, data, NULL);
1091 }
1092
1093 void
1094 gtk_timeout_remove (guint tag)
1095 {
1096   g_source_remove (tag);
1097 }
1098
1099 guint
1100 gtk_idle_add_full (gint                 priority,
1101                    GtkFunction          function,
1102                    GtkCallbackMarshal   marshal,
1103                    gpointer             data,
1104                    GtkDestroyNotify     destroy)
1105 {
1106   if (marshal)
1107     {
1108       GtkClosure *closure;
1109
1110       closure = g_new (GtkClosure, 1);
1111       closure->marshal = marshal;
1112       closure->data = data;
1113       closure->destroy = destroy;
1114
1115       return g_idle_add_full (priority,
1116                               gtk_invoke_idle_timeout,
1117                               closure,
1118                               gtk_destroy_closure);
1119     }
1120   else
1121     return g_idle_add_full (priority, function, data, destroy);
1122 }
1123
1124 guint
1125 gtk_idle_add (GtkFunction function,
1126               gpointer    data)
1127 {
1128   return g_idle_add_full (GTK_PRIORITY_DEFAULT, function, data, NULL);
1129 }
1130
1131 guint
1132 gtk_idle_add_priority   (gint               priority,
1133                          GtkFunction        function,
1134                          gpointer           data)
1135 {
1136   return g_idle_add_full (priority, function, data, NULL);
1137 }
1138
1139 void
1140 gtk_idle_remove (guint tag)
1141 {
1142   g_source_remove (tag);
1143 }
1144
1145 void
1146 gtk_idle_remove_by_data (gpointer data)
1147 {
1148   if (!g_idle_remove_by_data (data))
1149     g_warning ("gtk_idle_remove_by_data(%p): no such idle", data);
1150 }
1151
1152 guint
1153 gtk_input_add_full (gint                source,
1154                     GdkInputCondition   condition,
1155                     GdkInputFunction    function,
1156                     GtkCallbackMarshal  marshal,
1157                     gpointer            data,
1158                     GtkDestroyNotify    destroy)
1159 {
1160   if (marshal)
1161     {
1162       GtkClosure *closure;
1163
1164       closure = g_new (GtkClosure, 1);
1165       closure->marshal = marshal;
1166       closure->data = data;
1167       closure->destroy = destroy;
1168
1169       return gdk_input_add_full (source,
1170                                  condition,
1171                                  (GdkInputFunction) gtk_invoke_input,
1172                                  closure,
1173                                  (GdkDestroyNotify) gtk_destroy_closure);
1174     }
1175   else
1176     return gdk_input_add_full (source, condition, function, data, destroy);
1177 }
1178
1179 void
1180 gtk_input_remove (guint tag)
1181 {
1182   g_source_remove (tag);
1183 }
1184
1185 static void
1186 gtk_destroy_closure (gpointer data)
1187 {
1188   GtkClosure *closure = data;
1189
1190   if (closure->destroy)
1191     (closure->destroy) (closure->data);
1192   g_free (closure);
1193 }
1194
1195 static gboolean
1196 gtk_invoke_idle_timeout (gpointer data)
1197 {
1198   GtkClosure *closure = data;
1199
1200   GtkArg args[1];
1201   gint ret_val = FALSE;
1202   args[0].name = NULL;
1203   args[0].type = GTK_TYPE_BOOL;
1204   args[0].d.pointer_data = &ret_val;
1205   closure->marshal (NULL, closure->data,  0, args);
1206   return ret_val;
1207 }
1208
1209 static void
1210 gtk_invoke_input (gpointer          data,
1211                   gint              source,
1212                   GdkInputCondition condition)
1213 {
1214   GtkClosure *closure = data;
1215
1216   GtkArg args[3];
1217   args[0].type = GTK_TYPE_INT;
1218   args[0].name = NULL;
1219   GTK_VALUE_INT(args[0]) = source;
1220   args[1].type = GTK_TYPE_GDK_INPUT_CONDITION;
1221   args[1].name = NULL;
1222   GTK_VALUE_FLAGS(args[1]) = condition;
1223   args[2].type = GTK_TYPE_NONE;
1224   args[2].name = NULL;
1225
1226   closure->marshal (NULL, closure->data, 2, args);
1227 }
1228
1229 GdkEvent*
1230 gtk_get_current_event (void)
1231 {
1232   if (current_events)
1233     return gdk_event_copy ((GdkEvent *) current_events->data);
1234   else
1235     return NULL;
1236 }
1237
1238 GtkWidget*
1239 gtk_get_event_widget (GdkEvent *event)
1240 {
1241   GtkWidget *widget;
1242
1243   widget = NULL;
1244   if (event && event->any.window)
1245     gdk_window_get_user_data (event->any.window, (void**) &widget);
1246
1247   return widget;
1248 }
1249
1250 static void
1251 gtk_exit_func (void)
1252 {
1253   if (gtk_initialized)
1254     {
1255       gtk_initialized = FALSE;
1256       gtk_preview_uninit ();
1257     }
1258 }
1259
1260
1261 static gint
1262 gtk_quit_invoke_function (GtkQuitFunction *quitf)
1263 {
1264   if (!quitf->marshal)
1265     return quitf->function (quitf->data);
1266   else
1267     {
1268       GtkArg args[1];
1269       gint ret_val = FALSE;
1270
1271       args[0].name = NULL;
1272       args[0].type = GTK_TYPE_BOOL;
1273       args[0].d.pointer_data = &ret_val;
1274       ((GtkCallbackMarshal) quitf->marshal) (NULL,
1275                                              quitf->data,
1276                                              0, args);
1277       return ret_val;
1278     }
1279 }
1280
1281 void
1282 gtk_propagate_event (GtkWidget *widget,
1283                      GdkEvent  *event)
1284 {
1285   gint handled_event;
1286
1287   g_return_if_fail (widget != NULL);
1288   g_return_if_fail (GTK_IS_WIDGET (widget));
1289   g_return_if_fail (event != NULL);
1290
1291   handled_event = FALSE;
1292
1293   if ((event->type == GDK_KEY_PRESS) ||
1294       (event->type == GDK_KEY_RELEASE))
1295     {
1296       /* Only send key events within Window widgets to the Window
1297        *  The Window widget will in turn pass the
1298        *  key event on to the currently focused widget
1299        *  for that window.
1300        */
1301       GtkWidget *window;
1302
1303       window = gtk_widget_get_ancestor (widget, GTK_TYPE_WINDOW);
1304       if (window)
1305         {
1306           if (GTK_WIDGET_IS_SENSITIVE (window))
1307             gtk_widget_event (window, event);
1308
1309           handled_event = TRUE; /* don't send to widget */
1310         }
1311     }
1312
1313   /* Other events get propagated up the widget tree
1314    *  so that parents can see the button and motion
1315    *  events of the children.
1316    */
1317   while (!handled_event && widget)
1318     {
1319       GtkWidget *tmp;
1320
1321       gtk_widget_ref (widget);
1322       handled_event = !GTK_WIDGET_IS_SENSITIVE (widget) || gtk_widget_event (widget, event);
1323       tmp = widget->parent;
1324       gtk_widget_unref (widget);
1325       widget  = tmp;
1326     }
1327 }
1328
1329 #if 0
1330 static void
1331 gtk_error (gchar *str)
1332 {
1333   gtk_print (str);
1334 }
1335
1336 static void
1337 gtk_warning (gchar *str)
1338 {
1339   gtk_print (str);
1340 }
1341
1342 static void
1343 gtk_message (gchar *str)
1344 {
1345   gtk_print (str);
1346 }
1347
1348 static void
1349 gtk_print (gchar *str)
1350 {
1351   static GtkWidget *window = NULL;
1352   static GtkWidget *text;
1353   static int level = 0;
1354   GtkWidget *box1;
1355   GtkWidget *box2;
1356   GtkWidget *table;
1357   GtkWidget *hscrollbar;
1358   GtkWidget *vscrollbar;
1359   GtkWidget *separator;
1360   GtkWidget *button;
1361
1362   if (level > 0)
1363     {
1364       fputs (str, stdout);
1365       fflush (stdout);
1366       return;
1367     }
1368
1369   if (!window)
1370     {
1371       window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
1372
1373       gtk_signal_connect (GTK_OBJECT (window), "destroy",
1374                           (GtkSignalFunc) gtk_widget_destroyed,
1375                           &window);
1376
1377       gtk_window_set_title (GTK_WINDOW (window), "Messages");
1378
1379       box1 = gtk_vbox_new (FALSE, 0);
1380       gtk_container_add (GTK_CONTAINER (window), box1);
1381       gtk_widget_show (box1);
1382
1383
1384       box2 = gtk_vbox_new (FALSE, 10);
1385       gtk_container_set_border_width (GTK_CONTAINER (box2), 10);
1386       gtk_box_pack_start (GTK_BOX (box1), box2, TRUE, TRUE, 0);
1387       gtk_widget_show (box2);
1388
1389
1390       table = gtk_table_new (2, 2, FALSE);
1391       gtk_table_set_row_spacing (GTK_TABLE (table), 0, 2);
1392       gtk_table_set_col_spacing (GTK_TABLE (table), 0, 2);
1393       gtk_box_pack_start (GTK_BOX (box2), table, TRUE, TRUE, 0);
1394       gtk_widget_show (table);
1395
1396       text = gtk_text_new (NULL, NULL);
1397       gtk_text_set_editable (GTK_TEXT (text), FALSE);
1398       gtk_table_attach_defaults (GTK_TABLE (table), text, 0, 1, 0, 1);
1399       gtk_widget_show (text);
1400       gtk_widget_realize (text);
1401
1402       hscrollbar = gtk_hscrollbar_new (GTK_TEXT (text)->hadj);
1403       gtk_table_attach (GTK_TABLE (table), hscrollbar, 0, 1, 1, 2,
1404                         GTK_EXPAND | GTK_FILL, GTK_FILL, 0, 0);
1405       gtk_widget_show (hscrollbar);
1406
1407       vscrollbar = gtk_vscrollbar_new (GTK_TEXT (text)->vadj);
1408       gtk_table_attach (GTK_TABLE (table), vscrollbar, 1, 2, 0, 1,
1409                         GTK_FILL, GTK_EXPAND | GTK_FILL, 0, 0);
1410       gtk_widget_show (vscrollbar);
1411
1412       separator = gtk_hseparator_new ();
1413       gtk_box_pack_start (GTK_BOX (box1), separator, FALSE, TRUE, 0);
1414       gtk_widget_show (separator);
1415
1416
1417       box2 = gtk_vbox_new (FALSE, 10);
1418       gtk_container_set_border_width (GTK_CONTAINER (box2), 10);
1419       gtk_box_pack_start (GTK_BOX (box1), box2, FALSE, TRUE, 0);
1420       gtk_widget_show (box2);
1421
1422
1423       button = gtk_button_new_with_label ("close");
1424       gtk_signal_connect_object (GTK_OBJECT (button), "clicked",
1425                                  (GtkSignalFunc) gtk_widget_hide,
1426                                  GTK_OBJECT (window));
1427       gtk_box_pack_start (GTK_BOX (box2), button, TRUE, TRUE, 0);
1428       GTK_WIDGET_SET_FLAGS (button, GTK_CAN_DEFAULT);
1429       gtk_widget_grab_default (button);
1430       gtk_widget_show (button);
1431     }
1432
1433   level += 1;
1434   gtk_text_insert (GTK_TEXT (text), NULL, NULL, NULL, str, -1);
1435   level -= 1;
1436
1437   if (!GTK_WIDGET_VISIBLE (window))
1438     gtk_widget_show (window);
1439 }
1440 #endif