]> Pileus Git - ~andy/gtk/blob - gdk/gdk.h
better error message if you try to add a widget to a bin that already has
[~andy/gtk] / gdk / gdk.h
1 /* GDK - The GIMP Drawing Kit
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 Lesser 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  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser 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-2000.  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 #ifndef __GDK_H__
28 #define __GDK_H__
29
30 #include <gdk/gdkcolor.h>
31 #include <gdk/gdkcursor.h>
32 #include <gdk/gdkdnd.h>
33 #include <gdk/gdkdrawable.h>
34 #include <gdk/gdkevents.h>
35 #include <gdk/gdkfont.h>
36 #include <gdk/gdkgc.h>
37 #include <gdk/gdkim.h>
38 #include <gdk/gdkimage.h>
39 #include <gdk/gdkinput.h>
40 #include <gdk/gdkkeys.h>
41 #include <gdk/gdkpango.h>
42 #include <gdk/gdkpixbuf.h>
43 #include <gdk/gdkpixmap.h>
44 #include <gdk/gdkproperty.h>
45 #include <gdk/gdkregion.h>
46 #include <gdk/gdkrgb.h>
47 #include <gdk/gdkselection.h>
48 #include <gdk/gdktypes.h>
49 #include <gdk/gdkvisual.h>
50 #include <gdk/gdkwindow.h>
51
52 #include <gdk/gdkcompat.h>
53
54 #ifdef __cplusplus
55 extern "C" {
56 #endif /* __cplusplus */
57
58
59 /* Initialization, exit and events
60  */
61 #define   GDK_PRIORITY_EVENTS           (G_PRIORITY_DEFAULT)
62 void      gdk_init                      (gint           *argc,
63                                          gchar        ***argv);
64 gboolean  gdk_init_check                (gint           *argc,
65                                          gchar        ***argv);
66 void      gdk_exit                      (gint            error_code);
67 gchar*    gdk_set_locale                (void);
68
69 /* Push and pop error handlers for X errors
70  */
71 void      gdk_error_trap_push           (void);
72 gint      gdk_error_trap_pop            (void);
73
74
75 void      gdk_set_use_xshm              (gboolean        use_xshm);
76
77 gboolean  gdk_get_use_xshm              (void);
78 gchar*    gdk_get_display               (void);
79
80 gint gdk_input_add_full   (gint              source,
81                            GdkInputCondition condition,
82                            GdkInputFunction  function,
83                            gpointer          data,
84                            GdkDestroyNotify  destroy);
85 gint gdk_input_add        (gint              source,
86                            GdkInputCondition condition,
87                            GdkInputFunction  function,
88                            gpointer          data);
89 void gdk_input_remove     (gint              tag);
90
91 GdkGrabStatus gdk_pointer_grab       (GdkWindow    *window,
92                                       gboolean      owner_events,
93                                       GdkEventMask  event_mask,
94                                       GdkWindow    *confine_to,
95                                       GdkCursor    *cursor,
96                                       guint32       time);
97 void          gdk_pointer_ungrab     (guint32       time);
98 GdkGrabStatus gdk_keyboard_grab      (GdkWindow    *window,
99                                       gboolean      owner_events,
100                                       guint32       time);
101 void          gdk_keyboard_ungrab    (guint32       time);
102 gboolean      gdk_pointer_is_grabbed (void);
103
104 gint gdk_screen_width  (void) G_GNUC_CONST;
105 gint gdk_screen_height (void) G_GNUC_CONST;
106
107 gint gdk_screen_width_mm  (void) G_GNUC_CONST;
108 gint gdk_screen_height_mm (void) G_GNUC_CONST;
109
110 void gdk_flush (void);
111 void gdk_beep (void);
112
113 void gdk_key_repeat_disable (void);
114 void gdk_key_repeat_restore (void);
115
116 /* Rectangle utilities
117  */
118 gboolean gdk_rectangle_intersect (GdkRectangle *src1,
119                                   GdkRectangle *src2,
120                                   GdkRectangle *dest);
121 void     gdk_rectangle_union     (GdkRectangle *src1,
122                                   GdkRectangle *src2,
123                                   GdkRectangle *dest);
124
125 /* Conversion functions between wide char and multibyte strings. 
126  */
127 gchar     *gdk_wcstombs          (const GdkWChar   *src);
128 gint       gdk_mbstowcs          (GdkWChar         *dest,
129                                   const gchar      *src,
130                                   gint              dest_max);
131
132 /* Miscellaneous */
133 void     gdk_event_send_clientmessage_toall (GdkEvent    *event);
134 gboolean gdk_event_send_client_message (GdkEvent    *event,
135                                         guint32      xid);
136
137 /* Threading
138  */
139
140 GDKVAR GMutex *gdk_threads_mutex;
141
142 void     gdk_threads_enter                (void);
143 void     gdk_threads_leave                (void);
144
145 #ifdef  G_THREADS_ENABLED
146 #  define GDK_THREADS_ENTER()   G_STMT_START {  \
147       if (gdk_threads_mutex)                    \
148         g_mutex_lock (gdk_threads_mutex);       \
149    } G_STMT_END
150 #  define GDK_THREADS_LEAVE()   G_STMT_START {  \
151       if (gdk_threads_mutex)                    \
152         g_mutex_unlock (gdk_threads_mutex);     \
153    } G_STMT_END
154 #else   /* !G_THREADS_ENABLED */
155 #  define GDK_THREADS_ENTER()
156 #  define GDK_THREADS_LEAVE()
157 #endif  /* !G_THREADS_ENABLED */
158
159 #ifdef __cplusplus
160 }
161 #endif /* __cplusplus */
162
163
164 #endif /* __GDK_H__ */