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