]> Pileus Git - ~andy/gtk/blob - gdk/gdk.h
More updates.
[~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/gdkenumtypes.h>
35 #include <gdk/gdkevents.h>
36 #include <gdk/gdkfont.h>
37 #include <gdk/gdkgc.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 #ifdef __cplusplus
53 extern "C" {
54 #endif /* __cplusplus */
55
56
57 /* Initialization, exit and events
58  */
59 #define   GDK_PRIORITY_EVENTS           (G_PRIORITY_DEFAULT)
60 void      gdk_init                      (gint           *argc,
61                                          gchar        ***argv);
62 gboolean  gdk_init_check                (gint           *argc,
63                                          gchar        ***argv);
64
65 #ifndef GDK_DISABLE_DEPRECATED
66 void      gdk_exit                      (gint            error_code);
67 #endif /* GDK_DISABLE_DEPRECATED */
68 gchar*    gdk_set_locale                (void);
69
70 G_CONST_RETURN char *gdk_get_program_class (void);
71 void                 gdk_set_program_class (const char *program_class);
72
73 /* Push and pop error handlers for X errors
74  */
75 void      gdk_error_trap_push           (void);
76 gint      gdk_error_trap_pop            (void);
77
78 #ifndef GDK_DISABLE_DEPRECATED
79 void      gdk_set_use_xshm              (gboolean        use_xshm);
80 gboolean  gdk_get_use_xshm              (void);
81 #endif /* GDK_DISABLE_DEPRECATED */
82
83 gchar*    gdk_get_display               (void);
84
85 #ifndef GDK_DISABLE_DEPRECATED
86 gint gdk_input_add_full   (gint              source,
87                            GdkInputCondition condition,
88                            GdkInputFunction  function,
89                            gpointer          data,
90                            GdkDestroyNotify  destroy);
91 gint gdk_input_add        (gint              source,
92                            GdkInputCondition condition,
93                            GdkInputFunction  function,
94                            gpointer          data);
95 void gdk_input_remove     (gint              tag);
96 #endif /* GDK_DISABLE_DEPRECATED */
97
98 GdkGrabStatus gdk_pointer_grab       (GdkWindow    *window,
99                                       gboolean      owner_events,
100                                       GdkEventMask  event_mask,
101                                       GdkWindow    *confine_to,
102                                       GdkCursor    *cursor,
103                                       guint32       time);
104 void          gdk_pointer_ungrab     (guint32       time);
105 GdkGrabStatus gdk_keyboard_grab      (GdkWindow    *window,
106                                       gboolean      owner_events,
107                                       guint32       time);
108 void          gdk_keyboard_ungrab    (guint32       time);
109 gboolean      gdk_pointer_is_grabbed (void);
110
111 gint gdk_screen_width  (void) G_GNUC_CONST;
112 gint gdk_screen_height (void) G_GNUC_CONST;
113
114 gint gdk_screen_width_mm  (void) G_GNUC_CONST;
115 gint gdk_screen_height_mm (void) G_GNUC_CONST;
116
117 void gdk_flush (void);
118 void gdk_beep (void);
119
120 void gdk_set_double_click_time (guint msec);
121
122 /* Rectangle utilities
123  */
124 gboolean gdk_rectangle_intersect (GdkRectangle *src1,
125                                   GdkRectangle *src2,
126                                   GdkRectangle *dest);
127 void     gdk_rectangle_union     (GdkRectangle *src1,
128                                   GdkRectangle *src2,
129                                   GdkRectangle *dest);
130
131 GType gdk_rectangle_get_type (void);
132
133 #define GDK_TYPE_RECTANGLE (gdk_rectangle_get_type ())
134
135 /* Conversion functions between wide char and multibyte strings. 
136  */
137 gchar     *gdk_wcstombs          (const GdkWChar   *src);
138 gint       gdk_mbstowcs          (GdkWChar         *dest,
139                                   const gchar      *src,
140                                   gint              dest_max);
141
142 /* Miscellaneous */
143 void     gdk_event_send_clientmessage_toall (GdkEvent    *event);
144 gboolean gdk_event_send_client_message (GdkEvent    *event,
145                                         guint32      xid);
146
147 /* Threading
148  */
149
150 GDKVAR GMutex *gdk_threads_mutex;
151
152 void     gdk_threads_enter                (void);
153 void     gdk_threads_leave                (void);
154 void     gdk_threads_init                 (void);  
155
156 #ifdef  G_THREADS_ENABLED
157 #  define GDK_THREADS_ENTER()   G_STMT_START {  \
158       if (gdk_threads_mutex)                    \
159         g_mutex_lock (gdk_threads_mutex);       \
160    } G_STMT_END
161 #  define GDK_THREADS_LEAVE()   G_STMT_START {  \
162       if (gdk_threads_mutex)                    \
163         g_mutex_unlock (gdk_threads_mutex);     \
164    } G_STMT_END
165 #else   /* !G_THREADS_ENABLED */
166 #  define GDK_THREADS_ENTER()
167 #  define GDK_THREADS_LEAVE()
168 #endif  /* !G_THREADS_ENABLED */
169
170 #ifdef __cplusplus
171 }
172 #endif /* __cplusplus */
173
174
175 #endif /* __GDK_H__ */