]> Pileus Git - ~andy/gtk/blob - gdk/gdkdisplay.h
Add G_GNUC_DEPRECATED annotations in GDK
[~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/gdktypes.h>
32 #include <gdk/gdkevents.h>
33 #include <gdk/gdkdevicemanager.h>
34
35 G_BEGIN_DECLS
36
37 #define GDK_TYPE_DISPLAY              (gdk_display_get_type ())
38 #define GDK_DISPLAY(object)           (G_TYPE_CHECK_INSTANCE_CAST ((object), GDK_TYPE_DISPLAY, GdkDisplay))
39 #define GDK_IS_DISPLAY(object)        (G_TYPE_CHECK_INSTANCE_TYPE ((object), GDK_TYPE_DISPLAY))
40 #ifndef GDK_DISABLE_DEPRECATED
41 #define GDK_DISPLAY_OBJECT(object)    GDK_DISPLAY(object)
42 #endif
43
44 GType       gdk_display_get_type (void) G_GNUC_CONST;
45 GdkDisplay *gdk_display_open                (const gchar *display_name);
46
47 const gchar * gdk_display_get_name         (GdkDisplay *display);
48
49 gint        gdk_display_get_n_screens      (GdkDisplay  *display);
50 GdkScreen * gdk_display_get_screen         (GdkDisplay  *display,
51                                             gint         screen_num);
52 GdkScreen * gdk_display_get_default_screen (GdkDisplay  *display);
53
54 #ifndef GDK_MULTIDEVICE_SAFE
55 #ifndef GDK_DISABLE_DEPRECATED
56 void        gdk_display_pointer_ungrab     (GdkDisplay  *display,
57                                             guint32      time_) G_GNUC_DEPRECATED_FOR(gdk_device_ungrab);
58 void        gdk_display_keyboard_ungrab    (GdkDisplay  *display,
59                                             guint32      time_) G_GNUC_DEPRECATED_FOR(gdk_device_ungrab);
60 gboolean    gdk_display_pointer_is_grabbed (GdkDisplay  *display) G_GNUC_DEPRECATED_FOR(gdk_display_device_is_grabbed);
61 #endif /* GDK_DISABLE_DEPRECATED */
62 #endif /* GDK_MULTIDEVICE_SAFE */
63
64 gboolean    gdk_display_device_is_grabbed  (GdkDisplay  *display,
65                                             GdkDevice   *device);
66 void        gdk_display_beep               (GdkDisplay  *display);
67 void        gdk_display_sync               (GdkDisplay  *display);
68 void        gdk_display_flush              (GdkDisplay  *display);
69
70 void        gdk_display_close                  (GdkDisplay  *display);
71 gboolean    gdk_display_is_closed          (GdkDisplay  *display);
72
73 #ifndef GDK_DISABLE_DEPRECATED
74 GList *     gdk_display_list_devices       (GdkDisplay  *display) G_GNUC_DEPRECATED_FOR(gdk_device_manager_list_devices);
75 #endif /* GDK_DISABLE_DEPRECATED */
76
77 GdkEvent* gdk_display_get_event  (GdkDisplay     *display);
78 GdkEvent* gdk_display_peek_event (GdkDisplay     *display);
79 void      gdk_display_put_event  (GdkDisplay     *display,
80                                   const GdkEvent *event);
81 gboolean  gdk_display_has_pending (GdkDisplay  *display);
82
83 void gdk_display_set_double_click_time     (GdkDisplay   *display,
84                                             guint         msec);
85 void gdk_display_set_double_click_distance (GdkDisplay   *display,
86                                             guint         distance);
87
88 GdkDisplay *gdk_display_get_default (void);
89
90 #ifndef GDK_MULTIDEVICE_SAFE
91 #ifndef GDK_DISABLE_DEPRECATED
92 void             gdk_display_get_pointer           (GdkDisplay             *display,
93                                                     GdkScreen             **screen,
94                                                     gint                   *x,
95                                                     gint                   *y,
96                                                     GdkModifierType        *mask) G_GNUC_DEPRECATED_FOR(gdk_device_get_position);
97 GdkWindow *      gdk_display_get_window_at_pointer (GdkDisplay             *display,
98                                                     gint                   *win_x,
99                                                     gint                   *win_y) G_GNUC_DEPRECATED_FOR(gdk_device_get_window_at_position);
100 void             gdk_display_warp_pointer          (GdkDisplay             *display,
101                                                     GdkScreen              *screen,
102                                                     gint                   x,
103                                                     gint                   y) G_GNUC_DEPRECATED_FOR(gdk_device_warp);
104 #endif /* GDK_DISABLE_DEPRECATED */
105 #endif /* GDK_MULTIDEVICE_SAFE */
106
107 GdkDisplay *gdk_display_open_default_libgtk_only (void);
108
109 gboolean gdk_display_supports_cursor_alpha     (GdkDisplay    *display);
110 gboolean gdk_display_supports_cursor_color     (GdkDisplay    *display);
111 guint    gdk_display_get_default_cursor_size   (GdkDisplay    *display);
112 void     gdk_display_get_maximal_cursor_size   (GdkDisplay    *display,
113                                                 guint         *width,
114                                                 guint         *height);
115
116 GdkWindow *gdk_display_get_default_group       (GdkDisplay *display); 
117
118 gboolean gdk_display_supports_selection_notification (GdkDisplay *display);
119 gboolean gdk_display_request_selection_notification  (GdkDisplay *display,
120                                                       GdkAtom     selection);
121
122 gboolean gdk_display_supports_clipboard_persistence (GdkDisplay    *display);
123 void     gdk_display_store_clipboard                (GdkDisplay    *display,
124                                                      GdkWindow     *clipboard_window,
125                                                      guint32        time_,
126                                                      const GdkAtom *targets,
127                                                      gint           n_targets);
128
129 gboolean gdk_display_supports_shapes           (GdkDisplay    *display);
130 gboolean gdk_display_supports_input_shapes     (GdkDisplay    *display);
131 gboolean gdk_display_supports_composite        (GdkDisplay    *display);
132 void     gdk_display_notify_startup_complete   (GdkDisplay    *display,
133                                                 const gchar   *startup_id);
134
135 GdkDeviceManager * gdk_display_get_device_manager (GdkDisplay *display);
136
137 GdkAppLaunchContext *gdk_display_get_app_launch_context (GdkDisplay *display);
138
139 G_END_DECLS
140
141 #endif  /* __GDK_DISPLAY_H__ */