]> Pileus Git - ~andy/gtk/blob - gdk/gdkdisplay.h
gdk: Use versioned deprecations
[~andy/gtk] / gdk / gdkdisplay.h
1 /*
2  * gdkdisplay.h
3  *
4  * Copyright 2001 Sun Microsystems Inc.
5  *
6  * Erwann Chenede <erwann.chenede@sun.com>
7  *
8  * This library is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU Library General Public
10  * License as published by the Free Software Foundation; either
11  * version 2 of the License, or (at your option) any later version.
12  *
13  * This library is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
16  * Library General Public License for more details.
17  *
18  * You should have received a copy of the GNU Library General Public
19  * License along with this library; if not, write to the
20  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
21  * Boston, MA 02111-1307, USA.
22  */
23
24 #if !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
25 #error "Only <gdk/gdk.h> can be included directly."
26 #endif
27
28 #ifndef __GDK_DISPLAY_H__
29 #define __GDK_DISPLAY_H__
30
31 #include <gdk/gdkversionmacros.h>
32 #include <gdk/gdktypes.h>
33 #include <gdk/gdkevents.h>
34 #include <gdk/gdkdevicemanager.h>
35
36 G_BEGIN_DECLS
37
38 #define GDK_TYPE_DISPLAY              (gdk_display_get_type ())
39 #define GDK_DISPLAY(object)           (G_TYPE_CHECK_INSTANCE_CAST ((object), GDK_TYPE_DISPLAY, GdkDisplay))
40 #define GDK_IS_DISPLAY(object)        (G_TYPE_CHECK_INSTANCE_TYPE ((object), GDK_TYPE_DISPLAY))
41 #ifndef GDK_DISABLE_DEPRECATED
42 #define GDK_DISPLAY_OBJECT(object)    GDK_DISPLAY(object)
43 #endif
44
45 GType       gdk_display_get_type (void) G_GNUC_CONST;
46 GdkDisplay *gdk_display_open                (const gchar *display_name);
47
48 const gchar * gdk_display_get_name         (GdkDisplay *display);
49
50 gint        gdk_display_get_n_screens      (GdkDisplay  *display);
51 GdkScreen * gdk_display_get_screen         (GdkDisplay  *display,
52                                             gint         screen_num);
53 GdkScreen * gdk_display_get_default_screen (GdkDisplay  *display);
54
55 #ifndef GDK_MULTIDEVICE_SAFE
56 GDK_DEPRECATED_IN_3_0_FOR(gdk_device_ungrab)
57 void        gdk_display_pointer_ungrab     (GdkDisplay  *display,
58                                             guint32      time_);
59 GDK_DEPRECATED_IN_3_0_FOR(gdk_device_ungrab)
60 void        gdk_display_keyboard_ungrab    (GdkDisplay  *display,
61                                             guint32      time_);
62 GDK_DEPRECATED_IN_3_0_FOR(gdk_display_device_is_grabbed)
63 gboolean    gdk_display_pointer_is_grabbed (GdkDisplay  *display);
64 #endif /* GDK_MULTIDEVICE_SAFE */
65
66 gboolean    gdk_display_device_is_grabbed  (GdkDisplay  *display,
67                                             GdkDevice   *device);
68 void        gdk_display_beep               (GdkDisplay  *display);
69 void        gdk_display_sync               (GdkDisplay  *display);
70 void        gdk_display_flush              (GdkDisplay  *display);
71
72 void        gdk_display_close                  (GdkDisplay  *display);
73 gboolean    gdk_display_is_closed          (GdkDisplay  *display);
74
75 GDK_DEPRECATED_IN_3_0_FOR(gdk_device_manager_list_devices)
76 GList *     gdk_display_list_devices       (GdkDisplay  *display);
77
78 GdkEvent* gdk_display_get_event  (GdkDisplay     *display);
79 GdkEvent* gdk_display_peek_event (GdkDisplay     *display);
80 void      gdk_display_put_event  (GdkDisplay     *display,
81                                   const GdkEvent *event);
82 gboolean  gdk_display_has_pending (GdkDisplay  *display);
83
84 void gdk_display_set_double_click_time     (GdkDisplay   *display,
85                                             guint         msec);
86 void gdk_display_set_double_click_distance (GdkDisplay   *display,
87                                             guint         distance);
88
89 GdkDisplay *gdk_display_get_default (void);
90
91 #ifndef GDK_MULTIDEVICE_SAFE
92 GDK_DEPRECATED_IN_3_0_FOR(gdk_device_get_position)
93 void             gdk_display_get_pointer           (GdkDisplay             *display,
94                                                     GdkScreen             **screen,
95                                                     gint                   *x,
96                                                     gint                   *y,
97                                                     GdkModifierType        *mask);
98 GDK_DEPRECATED_IN_3_0_FOR(gdk_device_get_window_at_position)
99 GdkWindow *      gdk_display_get_window_at_pointer (GdkDisplay             *display,
100                                                     gint                   *win_x,
101                                                     gint                   *win_y);
102 GDK_DEPRECATED_IN_3_0_FOR(gdk_device_warp)
103 void             gdk_display_warp_pointer          (GdkDisplay             *display,
104                                                     GdkScreen              *screen,
105                                                     gint                   x,
106                                                     gint                   y);
107 #endif /* GDK_MULTIDEVICE_SAFE */
108
109 GdkDisplay *gdk_display_open_default_libgtk_only (void);
110
111 gboolean gdk_display_supports_cursor_alpha     (GdkDisplay    *display);
112 gboolean gdk_display_supports_cursor_color     (GdkDisplay    *display);
113 guint    gdk_display_get_default_cursor_size   (GdkDisplay    *display);
114 void     gdk_display_get_maximal_cursor_size   (GdkDisplay    *display,
115                                                 guint         *width,
116                                                 guint         *height);
117
118 GdkWindow *gdk_display_get_default_group       (GdkDisplay *display); 
119
120 gboolean gdk_display_supports_selection_notification (GdkDisplay *display);
121 gboolean gdk_display_request_selection_notification  (GdkDisplay *display,
122                                                       GdkAtom     selection);
123
124 gboolean gdk_display_supports_clipboard_persistence (GdkDisplay    *display);
125 void     gdk_display_store_clipboard                (GdkDisplay    *display,
126                                                      GdkWindow     *clipboard_window,
127                                                      guint32        time_,
128                                                      const GdkAtom *targets,
129                                                      gint           n_targets);
130
131 gboolean gdk_display_supports_shapes           (GdkDisplay    *display);
132 gboolean gdk_display_supports_input_shapes     (GdkDisplay    *display);
133 gboolean gdk_display_supports_composite        (GdkDisplay    *display);
134 void     gdk_display_notify_startup_complete   (GdkDisplay    *display,
135                                                 const gchar   *startup_id);
136
137 GdkDeviceManager * gdk_display_get_device_manager (GdkDisplay *display);
138
139 GdkAppLaunchContext *gdk_display_get_app_launch_context (GdkDisplay *display);
140
141 G_END_DECLS
142
143 #endif  /* __GDK_DISPLAY_H__ */