gdk.h 6.59 KB
Newer Older
Elliot Lee's avatar
Elliot Lee committed
1
2
3
4
/* GDK - The GIMP Drawing Kit
 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
 *
 * This library is free software; you can redistribute it and/or
5
 * modify it under the terms of the GNU Lesser General Public
Elliot Lee's avatar
Elliot Lee committed
6
7
8
9
10
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * 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.
Elliot Lee's avatar
Elliot Lee committed
13
 *
14
 * You should have received a copy of the GNU Lesser General Public
15
16
17
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
Elliot Lee's avatar
Elliot Lee committed
18
 */
19
20

/*
21
 * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
22
23
24
25
26
 * file for a list of people on the GTK+ Team.  See the ChangeLog
 * files for a list of changes.  These files are distributed with
 * GTK+ at ftp://ftp.gtk.org/pub/gtk/. 
 */

Elliot Lee's avatar
Elliot Lee committed
27
28
29
#ifndef __GDK_H__
#define __GDK_H__

Owen Taylor's avatar
Started    
Owen Taylor committed
30
31
#include <gdk/gdkcolor.h>
#include <gdk/gdkcursor.h>
32
#include <gdk/gdkdisplay.h>
Owen Taylor's avatar
Started    
Owen Taylor committed
33
34
#include <gdk/gdkdnd.h>
#include <gdk/gdkdrawable.h>
35
#include <gdk/gdkenumtypes.h>
Owen Taylor's avatar
Started    
Owen Taylor committed
36
37
38
39
40
#include <gdk/gdkevents.h>
#include <gdk/gdkfont.h>
#include <gdk/gdkgc.h>
#include <gdk/gdkimage.h>
#include <gdk/gdkinput.h>
Havoc Pennington's avatar
Havoc Pennington committed
41
#include <gdk/gdkkeys.h>
42
#include <gdk/gdkdisplaymanager.h>
43
#include <gdk/gdkpango.h>
Owen Taylor's avatar
Owen Taylor committed
44
#include <gdk/gdkpixbuf.h>
Owen Taylor's avatar
Started    
Owen Taylor committed
45
46
47
48
#include <gdk/gdkpixmap.h>
#include <gdk/gdkproperty.h>
#include <gdk/gdkregion.h>
#include <gdk/gdkrgb.h>
49
#include <gdk/gdkscreen.h>
Owen Taylor's avatar
Started    
Owen Taylor committed
50
#include <gdk/gdkselection.h>
Mark McLoughlin's avatar
Mark McLoughlin committed
51
#include <gdk/gdkspawn.h>
Elliot Lee's avatar
Elliot Lee committed
52
#include <gdk/gdktypes.h>
Owen Taylor's avatar
Started    
Owen Taylor committed
53
54
#include <gdk/gdkvisual.h>
#include <gdk/gdkwindow.h>
55

Elliot Lee's avatar
Elliot Lee committed
56
57
58
59
60
61
62
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */


/* Initialization, exit and events
 */
Tim Janik's avatar
Tim Janik committed
63
#define	  GDK_PRIORITY_EVENTS		(G_PRIORITY_DEFAULT)
64
65
void 	  gdk_parse_args	   	(gint	   	*argc,
					 gchar        ***argv);
66
67
void 	  gdk_init		   	(gint	   	*argc,
					 gchar        ***argv);
68
69
gboolean  gdk_init_check   	        (gint	   	*argc,
					 gchar        ***argv);
70
71
void gdk_add_option_entries_libgtk_only (GOptionGroup *group);
void gdk_pre_parse_libgtk_only          (void);
72

73
#ifndef GDK_DISABLE_DEPRECATED
74
void  	  gdk_exit		   	(gint	    	 error_code);
75
#endif /* GDK_DISABLE_DEPRECATED */
76
gchar*	  gdk_set_locale	   	(void);
Elliot Lee's avatar
Elliot Lee committed
77

78
79
80
G_CONST_RETURN char *gdk_get_program_class (void);
void                 gdk_set_program_class (const char *program_class);

81
82
83
84
85
/* Push and pop error handlers for X errors
 */
void      gdk_error_trap_push           (void);
gint      gdk_error_trap_pop            (void);

86
#ifndef GDK_DISABLE_DEPRECATED
Owen Taylor's avatar
Owen Taylor committed
87
88
void	  gdk_set_use_xshm		(gboolean	 use_xshm);
gboolean  gdk_get_use_xshm		(void);
89
90
#endif /* GDK_DISABLE_DEPRECATED */

91
92
gchar*	                  gdk_get_display		(void);
G_CONST_RETURN gchar*	  gdk_get_display_arg_name	(void);
Elliot Lee's avatar
Elliot Lee committed
93

Manish Singh's avatar
Manish Singh committed
94
95
#if !defined (GDK_DISABLE_DEPRECATED) || defined (GTK_COMPILATION)
/* Used by gtk_input_add_full () */
96
gint gdk_input_add_full	  (gint		     source,
97
98
			   GdkInputCondition condition,
			   GdkInputFunction  function,
99
			   gpointer	     data,
100
			   GdkDestroyNotify  destroy);
Manish Singh's avatar
Manish Singh committed
101
102
#endif /* !GDK_DISABLE_DEPRECATED || GTK_COMPILATION */
#ifndef GDK_DISABLE_DEPRECATED
103
gint gdk_input_add	  (gint		     source,
104
105
			   GdkInputCondition condition,
			   GdkInputFunction  function,
106
107
			   gpointer	     data);
void gdk_input_remove	  (gint		     tag);
108
#endif /* GDK_DISABLE_DEPRECATED */
109

110
111
112
113
114
GdkGrabStatus gdk_pointer_grab       (GdkWindow    *window,
				      gboolean      owner_events,
				      GdkEventMask  event_mask,
				      GdkWindow    *confine_to,
				      GdkCursor    *cursor,
115
				      guint32       time_);
116
117
GdkGrabStatus gdk_keyboard_grab      (GdkWindow    *window,
				      gboolean      owner_events,
118
				      guint32       time_);
119

120
121
122
123
124
125
126
gboolean gdk_pointer_grab_info_libgtk_only (GdkDisplay *display,
					    GdkWindow **grab_window,
					    gboolean   *owner_events);
gboolean gdk_keyboard_grab_info_libgtk_only (GdkDisplay *display,
					     GdkWindow **grab_window,
					     gboolean   *owner_events);

127
#ifndef GDK_MULTIHEAD_SAFE
128
129
void          gdk_pointer_ungrab     (guint32       time_);
void          gdk_keyboard_ungrab    (guint32       time_);
130
gboolean      gdk_pointer_is_grabbed (void);
131

132
133
gint gdk_screen_width  (void) G_GNUC_CONST;
gint gdk_screen_height (void) G_GNUC_CONST;
Elliot Lee's avatar
Elliot Lee committed
134

135
136
gint gdk_screen_width_mm  (void) G_GNUC_CONST;
gint gdk_screen_height_mm (void) G_GNUC_CONST;
137

Elliot Lee's avatar
Elliot Lee committed
138
void gdk_beep (void);
139
140
141
#endif /* GDK_MULTIHEAD_SAFE */

void gdk_flush (void);
Elliot Lee's avatar
Elliot Lee committed
142

143
144
145
#ifndef GDK_MULTIHEAD_SAFE
void gdk_set_double_click_time             (guint       msec);
#endif
146

Elliot Lee's avatar
Elliot Lee committed
147
148
/* Rectangle utilities
 */
Owen Taylor's avatar
Owen Taylor committed
149
150
151
152
153
154
gboolean gdk_rectangle_intersect (GdkRectangle *src1,
				  GdkRectangle *src2,
				  GdkRectangle *dest);
void     gdk_rectangle_union     (GdkRectangle *src1,
				  GdkRectangle *src2,
				  GdkRectangle *dest);
Elliot Lee's avatar
Elliot Lee committed
155

156
157
GType gdk_rectangle_get_type (void);

Owen Taylor's avatar
Owen Taylor committed
158
159
#define GDK_TYPE_RECTANGLE (gdk_rectangle_get_type ())

160
161
/* Conversion functions between wide char and multibyte strings. 
 */
162
#ifndef GDK_DISABLE_DEPRECATED
163
164
165
166
gchar     *gdk_wcstombs          (const GdkWChar   *src);
gint       gdk_mbstowcs          (GdkWChar         *dest,
				  const gchar      *src,
				  gint              dest_max);
167
#endif
168

Tim Janik's avatar
Tim Janik committed
169
/* Miscellaneous */
170
#ifndef GDK_MULTIHEAD_SAFE
Owen Taylor's avatar
Owen Taylor committed
171
172
gboolean gdk_event_send_client_message      (GdkEvent       *event,
					     GdkNativeWindow winid);
173
174
175
void     gdk_event_send_clientmessage_toall (GdkEvent  *event);
#endif
gboolean gdk_event_send_client_message_for_display (GdkDisplay *display,
Owen Taylor's avatar
Owen Taylor committed
176
177
						    GdkEvent       *event,
						    GdkNativeWindow winid);
178
179
180

void gdk_notify_startup_complete (void);

181
182
183
/* Threading
 */

184
185
186
187
188
189
#if !defined (GDK_DISABLE_DEPRECATED) || defined (GDK_COMPILATION)
GDKVAR GMutex *gdk_threads_mutex; /* private */
#endif

GDKVAR GCallback gdk_threads_lock;
GDKVAR GCallback gdk_threads_unlock;
190
191
192

void     gdk_threads_enter                (void);
void     gdk_threads_leave                (void);
193
194
195
void     gdk_threads_init                 (void);
void     gdk_threads_set_lock_functions   (GCallback enter_fn,
					   GCallback leave_fn);
196
197
198

#ifdef	G_THREADS_ENABLED
#  define GDK_THREADS_ENTER()	G_STMT_START {	\
199
200
      if (gdk_threads_lock)                 	\
        (*gdk_threads_lock) ();			\
201
202
   } G_STMT_END
#  define GDK_THREADS_LEAVE()	G_STMT_START { 	\
203
204
      if (gdk_threads_unlock)                 	\
        (*gdk_threads_unlock) ();		\
205
206
207
208
209
   } G_STMT_END
#else	/* !G_THREADS_ENABLED */
#  define GDK_THREADS_ENTER()
#  define GDK_THREADS_LEAVE()
#endif	/* !G_THREADS_ENABLED */
210

Elliot Lee's avatar
Elliot Lee committed
211
212
213
214
215
216
#ifdef __cplusplus
}
#endif /* __cplusplus */


#endif /* __GDK_H__ */