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

   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 #ifndef __GTK_MAIN_H__
  20 #define __GTK_MAIN_H__
  21
  22
  23 #include <gdk/gdk.h>
  24 #include <gtk/gtkwidget.h>
  25
  26
  27 #ifdef __cplusplus
  28 extern "C" {
  29 #endif /* __cplusplus */
  30
  31 #define GTK_PRIORITY_HIGH      -20
  32 #define GTK_PRIORITY_INTERNAL  -10
  33 #define GTK_PRIORITY_DEFAULT    -5
  34 #define GTK_PRIORITY_LOW        10
  35
  36 typedef void    (*GtkModuleInitFunc)    (gint           *argc,
  37                                          gchar        ***argv);
  38 typedef gint    (*GtkKeySnoopFunc)      (GtkWidget      *grab_widget,
  39                                          GdkEventKey    *event,
  40                                          gpointer        func_data);
  41
  42 /* Gtk version.
  43  */
  44 extern const guint gtk_major_version;
  45 extern const guint gtk_minor_version;
  46 extern const guint gtk_micro_version;
  47 extern const guint gtk_binary_age;
  48 extern const guint gtk_interface_age;
  49 gchar* gtk_check_version (guint required_major,
  50                           guint required_minor,
  51                           guint required_micro);
  52
  53
  54 /* Initialization, exit, mainloop and miscellaneous routines
  55  */
  56 void       gtk_init              (int          *argc,
  57                                   char       ***argv);
  58 void       gtk_exit              (gint          error_code);
  59 gchar*     gtk_set_locale        (void);
  60 gint       gtk_events_pending    (void);
  61
  62 /* The following is the event func GTK+ registers with GDK
  63  * we expose it mainly to allow filtering of events between
  64  * GDK and GTK+.
  65  */
  66 void  gtk_main_do_event          (GdkEvent           *event);
  67
  68 void       gtk_main              (void);
  69 guint      gtk_main_level        (void);
  70 void       gtk_main_quit         (void);
  71 gint       gtk_main_iteration    (void);
  72 /* gtk_main_iteration() calls gtk_main_iteration_do(TRUE) */
  73 gint       gtk_main_iteration_do (gboolean blocking);
  74
  75 gint       gtk_true                (void);
  76 gint       gtk_false               (void);
  77
  78 void       gtk_grab_add            (GtkWidget          *widget);
  79 GtkWidget* gtk_grab_get_current    (void);
  80 void       gtk_grab_remove         (GtkWidget          *widget);
  81
  82 void       gtk_init_add            (GtkFunction        function,
  83                                     gpointer           data);
  84 void       gtk_quit_add_destroy    (guint              main_level,
  85                                     GtkObject         *object);
  86 guint      gtk_quit_add            (guint              main_level,
  87                                     GtkFunction        function,
  88                                     gpointer           data);
  89 guint      gtk_quit_add_full       (guint              main_level,
  90                                     GtkFunction        function,
  91                                     GtkCallbackMarshal marshal,
  92                                     gpointer           data,
  93                                     GtkDestroyNotify   destroy);
  94 void       gtk_quit_remove         (guint              quit_handler_id);
  95 void       gtk_quit_remove_by_data (gpointer           data);
  96 guint      gtk_timeout_add         (guint32            interval,
  97                                     GtkFunction        function,
  98                                     gpointer           data);
  99 guint      gtk_timeout_add_full    (guint32            interval,
 100                                     GtkFunction        function,
 101                                     GtkCallbackMarshal marshal,
 102                                     gpointer           data,
 103                                     GtkDestroyNotify   destroy);
 104 void       gtk_timeout_remove      (guint              timeout_handler_id);
 105
 106 guint      gtk_idle_add            (GtkFunction        function,
 107                                     gpointer           data);
 108 guint      gtk_idle_add_priority   (gint               priority,
 109                                     GtkFunction        function,
 110                                     gpointer           data);
 111 guint      gtk_idle_add_full       (gint               priority,
 112                                     GtkFunction        function,
 113                                     GtkCallbackMarshal marshal,
 114                                     gpointer           data,
 115                                     GtkDestroyNotify   destroy);
 116 void       gtk_idle_remove         (guint              idle_handler_id);
 117 void       gtk_idle_remove_by_data (gpointer           data);
 118 guint      gtk_input_add_full      (gint               source,
 119                                     GdkInputCondition  condition,
 120                                     GdkInputFunction   function,
 121                                     GtkCallbackMarshal marshal,
 122                                     gpointer           data,
 123                                     GtkDestroyNotify   destroy);
 124 void       gtk_input_remove        (guint              input_handler_id);
 125
 126
 127 guint      gtk_key_snooper_install (GtkKeySnoopFunc snooper,
 128                                     gpointer        func_data);
 129 void       gtk_key_snooper_remove  (guint           snooper_handler_id);
 130
 131 GdkEvent*  gtk_get_current_event   (void);
 132 GtkWidget* gtk_get_event_widget    (GdkEvent       *event);
 133
 134 void       gtk_threads_enter       (void);
 135 void       gtk_threads_leave       (void);
 136
 137 /* deprecated */
 138 guint      gtk_idle_add_interp     (GtkCallbackMarshal marshal,
 139                                     gpointer           data,
 140                                     GtkDestroyNotify   destroy);
 141 guint      gtk_timeout_add_interp  (guint32            interval,
 142                                     GtkCallbackMarshal function,
 143                                     gpointer           data,
 144                                     GtkDestroyNotify   notify);
 145
 146 #ifdef __cplusplus
 147 }
 148 #endif /* __cplusplus */
 149
 150
 151 #endif /* __GTK_MAIN_H__ */