1 /* GDK - The GIMP Drawing Kit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
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.
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.
14 * You should have received a copy of the GNU Library General Public
15 * License along with this library; if not, write to the Free
16 * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
22 #include <gdk/gdktypes.h>
23 #include <gdk/gdki18n.h>
28 #endif /* __cplusplus */
31 /* Initialization, exit and events
33 void gdk_init (int *argc,
35 void gdk_exit (int error_code);
36 gchar* gdk_set_locale (void);
38 gint gdk_events_pending (void);
39 gint gdk_event_get (GdkEvent *event,
42 void gdk_event_put (GdkEvent *event);
44 GdkEvent *gdk_event_copy (GdkEvent *event);
45 void gdk_event_free (GdkEvent *event);
47 void gdk_set_debug_level (gint level);
48 void gdk_set_show_events (gint show_events);
49 void gdk_set_use_xshm (gint use_xshm);
51 gint gdk_get_debug_level (void);
52 gint gdk_get_show_events (void);
53 gint gdk_get_use_xshm (void);
55 guint32 gdk_time_get (void);
56 guint32 gdk_timer_get (void);
57 void gdk_timer_set (guint32 milliseconds);
58 void gdk_timer_enable (void);
59 void gdk_timer_disable (void);
61 gint gdk_input_add (gint source,
62 GdkInputCondition condition,
63 GdkInputFunction function,
65 void gdk_input_remove (gint tag);
67 gint gdk_pointer_grab (GdkWindow * window,
69 GdkEventMask event_mask,
70 GdkWindow * confine_to,
73 void gdk_pointer_ungrab (guint32 time);
75 gint gdk_keyboard_grab (GdkWindow * window,
78 void gdk_keyboard_ungrab (guint32 time);
80 gint gdk_screen_width (void);
81 gint gdk_screen_height (void);
83 void gdk_flush (void);
86 void gdk_key_repeat_disable (void);
87 void gdk_key_repeat_restore (void);
92 gint gdk_visual_get_best_depth (void);
93 GdkVisualType gdk_visual_get_best_type (void);
94 GdkVisual* gdk_visual_get_system (void);
95 GdkVisual* gdk_visual_get_best (void);
96 GdkVisual* gdk_visual_get_best_with_depth (gint depth);
97 GdkVisual* gdk_visual_get_best_with_type (GdkVisualType visual_type);
98 GdkVisual* gdk_visual_get_best_with_both (gint depth,
99 GdkVisualType visual_type);
101 /* Actually, these are no-ops... */
102 GdkVisual* gdk_visual_ref (GdkVisual *visual);
103 void gdk_visual_unref (GdkVisual *visual);
105 void gdk_query_depths (gint **depths,
107 void gdk_query_visual_types (GdkVisualType **visual_types,
109 void gdk_query_visuals (GdkVisual **visuals,
115 GdkWindow* gdk_window_new (GdkWindow *parent,
116 GdkWindowAttr *attributes,
117 gint attributes_mask);
119 GdkWindow * gdk_window_foreign_new (guint32 anid);
120 void gdk_window_destroy (GdkWindow *window);
121 GdkWindow* gdk_window_ref (GdkWindow *window);
122 void gdk_window_unref (GdkWindow *window);
124 void gdk_window_show (GdkWindow *window);
125 void gdk_window_hide (GdkWindow *window);
126 void gdk_window_move (GdkWindow *window,
129 void gdk_window_resize (GdkWindow *window,
132 void gdk_window_move_resize (GdkWindow *window,
137 void gdk_window_reparent (GdkWindow *window,
138 GdkWindow *new_parent,
141 void gdk_window_clear (GdkWindow *window);
142 void gdk_window_clear_area (GdkWindow *window,
147 void gdk_window_clear_area_e(GdkWindow *window,
152 void gdk_window_copy_area (GdkWindow *window,
156 GdkWindow *source_window,
161 void gdk_window_raise (GdkWindow *window);
162 void gdk_window_lower (GdkWindow *window);
164 void gdk_window_set_user_data (GdkWindow *window,
169 * This allows for making shaped (partially transparent) windows
170 * - cool feature, needed for Drag and Drag for example.
171 * The shape_mask can be the mask
172 * from gdk_pixmap_create_from_xpm. Stefan Wille
174 void gdk_window_shape_combine_mask (GdkWindow *window,
175 GdkBitmap *shape_mask,
181 * Algorithm (drop source):
182 * A window being dragged will be sent a GDK_DRAG_BEGIN message.
183 * It will then do gdk_dnd_drag_addwindow() for any other windows that are to be
185 * When we get a DROP_ENTER incoming, we send it on to the window in question.
186 * That window needs to use gdk_dnd_drop_enter_reply() to indicate the state of
187 * things (it must call that even if it's not going to accept the drop)
189 * These two turn on/off drag or drop, and if enabling it also
190 * sets the list of types supported. The list of types passed in
191 * should be in order of decreasing preference.
193 void gdk_window_dnd_drag_set (GdkWindow *window,
199 *XXX todo: add a GDK_DROP_ENTER which can look at actual data
201 void gdk_window_dnd_drop_set (GdkWindow *window,
205 guint8 destructive_op);
208 * This is used by the GDK_DRAG_BEGIN handler. An example of usage would be a
209 * file manager where multiple icons were selected and the drag began.
210 * The icon that the drag actually began on would gdk_dnd_drag_addwindow
211 * for all the other icons that were being dragged...
213 void gdk_dnd_drag_addwindow (GdkWindow *window);
214 void gdk_window_dnd_data_set (GdkWindow *window,
217 gulong data_numbytes);
220 void gdk_window_set_hints (GdkWindow *window,
228 void gdk_window_set_title (GdkWindow *window,
230 void gdk_window_set_background (GdkWindow *window,
232 void gdk_window_set_back_pixmap (GdkWindow *window,
234 gint parent_relative);
235 void gdk_window_set_cursor (GdkWindow *window,
237 void gdk_window_set_colormap (GdkWindow *window,
238 GdkColormap *colormap);
239 void gdk_window_get_user_data (GdkWindow *window,
241 void gdk_window_get_geometry (GdkWindow *window,
247 void gdk_window_get_position (GdkWindow *window,
250 void gdk_window_get_size (GdkWindow *window,
253 GdkVisual* gdk_window_get_visual (GdkWindow *window);
254 GdkColormap* gdk_window_get_colormap (GdkWindow *window);
255 GdkWindowType gdk_window_get_type (GdkWindow *window);
256 gint gdk_window_get_origin (GdkWindow *window,
259 GdkWindow* gdk_window_get_pointer (GdkWindow *window,
262 GdkModifierType *mask);
263 GdkWindow* gdk_window_get_parent (GdkWindow *window);
264 GdkWindow* gdk_window_get_toplevel (GdkWindow *window);
265 GList* gdk_window_get_children (GdkWindow *window);
266 GdkEventMask gdk_window_get_events (GdkWindow *window);
267 void gdk_window_set_events (GdkWindow *window,
268 GdkEventMask event_mask);
272 GdkCursor* gdk_cursor_new (GdkCursorType cursor_type);
273 void gdk_cursor_destroy (GdkCursor *cursor);
278 GdkGC* gdk_gc_new (GdkWindow *window);
279 GdkGC* gdk_gc_new_with_values (GdkWindow *window,
281 GdkGCValuesMask values_mask);
282 void gdk_gc_destroy (GdkGC *gc);
283 void gdk_gc_get_values (GdkGC *gc,
284 GdkGCValues *values);
285 void gdk_gc_set_foreground (GdkGC *gc,
287 void gdk_gc_set_background (GdkGC *gc,
289 void gdk_gc_set_font (GdkGC *gc,
291 void gdk_gc_set_function (GdkGC *gc,
292 GdkFunction function);
293 void gdk_gc_set_fill (GdkGC *gc,
295 void gdk_gc_set_tile (GdkGC *gc,
297 void gdk_gc_set_stipple (GdkGC *gc,
299 void gdk_gc_set_ts_origin (GdkGC *gc,
302 void gdk_gc_set_clip_origin (GdkGC *gc,
305 void gdk_gc_set_clip_mask (GdkGC *gc,
307 void gdk_gc_set_clip_rectangle (GdkGC *gc,
308 GdkRectangle *rectangle);
309 void gdk_gc_set_subwindow (GdkGC *gc,
310 GdkSubwindowMode mode);
311 void gdk_gc_set_exposures (GdkGC *gc,
313 void gdk_gc_set_line_attributes (GdkGC *gc,
315 GdkLineStyle line_style,
316 GdkCapStyle cap_style,
317 GdkJoinStyle join_style);
322 GdkPixmap* gdk_pixmap_new (GdkWindow *window,
326 GdkBitmap* gdk_bitmap_create_from_data (GdkWindow *window,
330 GdkPixmap* gdk_pixmap_create_from_data (GdkWindow *window,
337 GdkPixmap* gdk_pixmap_create_from_xpm (GdkWindow *window,
339 GdkColor *transparent_color,
340 const gchar *filename);
341 GdkPixmap* gdk_pixmap_create_from_xpm_d (GdkWindow *window,
343 GdkColor *transparent_color,
345 void gdk_pixmap_destroy (GdkPixmap *pixmap);
351 GdkImage* gdk_image_new_bitmap(GdkVisual *,
355 GdkImage* gdk_image_new (GdkImageType type,
359 GdkImage* gdk_image_get (GdkWindow *window,
364 void gdk_image_put_pixel (GdkImage *image,
368 guint32 gdk_image_get_pixel (GdkImage *image,
371 void gdk_image_destroy (GdkImage *image);
376 GdkColormap* gdk_colormap_new (GdkVisual *visual,
378 void gdk_colormap_destroy (GdkColormap *colormap);
380 GdkColormap* gdk_colormap_ref (GdkColormap *cmap);
381 void gdk_colormap_unref (GdkColormap *cmap);
383 GdkColormap* gdk_colormap_get_system (void);
384 gint gdk_colormap_get_system_size (void);
386 void gdk_colormap_change (GdkColormap *colormap,
388 void gdk_colors_store (GdkColormap *colormap,
391 gint gdk_colors_alloc (GdkColormap *colormap,
397 void gdk_colors_free (GdkColormap *colormap,
401 gint gdk_color_white (GdkColormap *colormap,
403 gint gdk_color_black (GdkColormap *colormap,
405 gint gdk_color_parse (const gchar *spec,
407 gint gdk_color_alloc (GdkColormap *colormap,
409 gint gdk_color_change (GdkColormap *colormap,
411 gint gdk_color_equal (GdkColor *colora,
417 GdkFont* gdk_font_load (const gchar *font_name);
418 GdkFont* gdk_fontset_load (gchar *fontset_name);
419 void gdk_font_free (GdkFont *font);
420 void gdk_fontset_free (GdkFont *font);
421 GdkFont* gdk_font_ref (GdkFont *font);
422 gint gdk_font_id (GdkFont *font);
423 gint gdk_font_equal (GdkFont *fonta,
425 gint gdk_string_width (GdkFont *font,
426 const gchar *string);
427 gint gdk_text_width (GdkFont *font,
430 gint gdk_char_width (GdkFont *font,
432 gint gdk_string_measure (GdkFont *font,
433 const gchar *string);
434 gint gdk_text_measure (GdkFont *font,
437 gint gdk_char_measure (GdkFont *font,
443 void gdk_draw_point (GdkDrawable *drawable,
447 void gdk_draw_line (GdkDrawable *drawable,
453 void gdk_draw_rectangle (GdkDrawable *drawable,
460 void gdk_draw_arc (GdkDrawable *drawable,
469 void gdk_draw_polygon (GdkDrawable *drawable,
474 void gdk_draw_string (GdkDrawable *drawable,
479 const gchar *string);
480 void gdk_draw_text (GdkDrawable *drawable,
487 void gdk_draw_pixmap (GdkDrawable *drawable,
496 void gdk_draw_bitmap (GdkDrawable *drawable,
505 void gdk_draw_image (GdkDrawable *drawable,
514 void gdk_draw_points (GdkDrawable *drawable,
518 void gdk_draw_segments (GdkDrawable *drawable,
526 gint gdk_selection_owner_set (GdkWindow *owner,
530 GdkWindow* gdk_selection_owner_get (GdkAtom selection);
531 void gdk_selection_convert (GdkWindow *requestor,
535 gint gdk_selection_property_get (GdkWindow *requestor,
539 void gdk_selection_send_notify (guint32 requestor,
545 gint gdk_text_property_to_text_list (GdkAtom encoding, gint format,
546 guchar *text, gint length,
548 void gdk_free_text_list (gchar **list);
549 gint gdk_string_to_compound_text (gchar *str,
550 GdkAtom *encoding, gint *format,
551 guchar **ctext, gint *length);
552 void gdk_free_compound_text (guchar *ctext);
556 GdkAtom gdk_atom_intern (const gchar *atom_name,
557 gint only_if_exists);
558 gchar* gdk_atom_name (GdkAtom atom);
559 gint gdk_property_get (GdkWindow *window,
565 GdkAtom *actual_property_type,
570 void gdk_property_change (GdkWindow *window,
577 void gdk_property_delete (GdkWindow *window,
581 /* Rectangle utilities
583 gint gdk_rectangle_intersect (GdkRectangle *src1,
590 void gdk_input_init (void);
591 void gdk_input_exit (void);
592 GList *gdk_input_list_devices (void);
593 void gdk_input_set_extension_events (GdkWindow *window,
595 GdkExtensionMode mode);
596 void gdk_input_set_source (guint32 deviceid,
597 GdkInputSource source);
598 gint gdk_input_set_mode (guint32 deviceid,
600 void gdk_input_set_axes (guint32 deviceid,
602 void gdk_input_set_key (guint32 deviceid,
605 GdkModifierType modifiers);
606 void gdk_input_window_get_pointer (GdkWindow *window,
613 GdkModifierType *mask);
615 GdkTimeCoord *gdk_input_motion_events (GdkWindow *window,
619 gint *nevents_return);
622 /* International Input Method Support Functions
625 gint gdk_im_ready (void);
627 void gdk_im_begin (GdkIC ic, GdkWindow* window);
628 void gdk_im_end (void);
629 GdkIMStyle gdk_im_decide_style (GdkIMStyle supported_style);
630 GdkIMStyle gdk_im_set_best_style (GdkIMStyle best_allowed_style);
631 GdkIC gdk_ic_new (GdkWindow* client_window,
632 GdkWindow* focus_window,
633 GdkIMStyle style, ...);
634 void gdk_ic_destroy (GdkIC ic);
635 void gdk_ic_set_values (GdkIC ic, ...);
636 void gdk_ic_get_values (GdkIC ic, ...);
637 void gdk_ic_set_attr (GdkIC ic, const char *target, ...);
638 void gdk_ic_get_attr (GdkIC ic, const char *target, ...);
639 GdkEventMask gdk_ic_get_events (GdkIC ic);
644 void gdk_event_send_clientmessage_toall(GdkEvent *event);
648 #endif /* __cplusplus */
651 #endif /* __GDK_H__ */