gdkmain.h 4.43 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33
/* 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
 * modify it under the terms of the GNU Lesser General Public
 * 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
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
 */

/*
 * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
 * 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/.
 */

#if !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
#error "Only <gdk/gdk.h> can be included directly."
#endif

#ifndef __GDK_MAIN_H__
#define __GDK_MAIN_H__

34
#include <gdk/gdkversionmacros.h>
35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53
#include <gdk/gdktypes.h>

G_BEGIN_DECLS


/* Initialization, exit and events
 */

#define GDK_PRIORITY_EVENTS (G_PRIORITY_DEFAULT)

void                  gdk_parse_args                      (gint           *argc,
                                                           gchar        ***argv);
void                  gdk_init                            (gint           *argc,
                                                           gchar        ***argv);
gboolean              gdk_init_check                      (gint           *argc,
                                                           gchar        ***argv);
void                  gdk_add_option_entries_libgtk_only  (GOptionGroup   *group);
void                  gdk_pre_parse_libgtk_only           (void);

54
const gchar *         gdk_get_program_class               (void);
55 56 57 58 59 60 61 62 63 64 65 66 67
void                  gdk_set_program_class               (const gchar    *program_class);

void                  gdk_notify_startup_complete         (void);
void                  gdk_notify_startup_complete_with_id (const gchar* startup_id);

/* Push and pop error handlers for X errors
 */
void                           gdk_error_trap_push        (void);
/* warn unused because you could use pop_ignored otherwise */
G_GNUC_WARN_UNUSED_RESULT gint gdk_error_trap_pop         (void);
void                           gdk_error_trap_pop_ignored (void);


68
const gchar *         gdk_get_display_arg_name (void);
69 70 71 72

/**
 * gdk_get_display:
 *
73 74 75
 * Gets the name of the display, which usually comes from the
 * <envar>DISPLAY</envar> environment variable or the
 * <option>--display</option> command line option.
76 77 78
 *
 * Returns: the name of the display.
 */
79
gchar*        gdk_get_display        (void);
80 81

#ifndef GDK_MULTIDEVICE_SAFE
82
GDK_DEPRECATED_IN_3_0_FOR(gdk_device_grab)
83
GdkGrabStatus gdk_pointer_grab       (GdkWindow    *window,
84 85 86 87
                                      gboolean      owner_events,
                                      GdkEventMask  event_mask,
                                      GdkWindow    *confine_to,
                                      GdkCursor    *cursor,
88
                                      guint32       time_);
89
GDK_DEPRECATED_IN_3_0_FOR(gdk_device_grab)
90
GdkGrabStatus gdk_keyboard_grab      (GdkWindow    *window,
91
                                      gboolean      owner_events,
92
                                      guint32       time_);
93 94 95 96 97
#endif /* GDK_MULTIDEVICE_SAFE */

#ifndef GDK_MULTIHEAD_SAFE

#ifndef GDK_MULTIDEVICE_SAFE
98
GDK_DEPRECATED_IN_3_0_FOR(gdk_device_ungrab)
99
void          gdk_pointer_ungrab     (guint32       time_);
100
GDK_DEPRECATED_IN_3_0_FOR(gdk_device_ungrab)
101
void          gdk_keyboard_ungrab    (guint32       time_);
102
GDK_DEPRECATED_IN_3_0_FOR(gdk_display_device_is_grabbed)
103
gboolean      gdk_pointer_is_grabbed (void);
104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119
#endif /* GDK_MULTIDEVICE_SAFE */

gint gdk_screen_width  (void) G_GNUC_CONST;
gint gdk_screen_height (void) G_GNUC_CONST;

gint gdk_screen_width_mm  (void) G_GNUC_CONST;
gint gdk_screen_height_mm (void) G_GNUC_CONST;

void gdk_set_double_click_time (guint msec);

void gdk_beep (void);

#endif /* GDK_MULTIHEAD_SAFE */

void gdk_flush (void);

120 121
void gdk_disable_multidevice (void);

122 123 124
G_END_DECLS

#endif /* __GDK_MAIN_H__ */