/* * gdkdisplay.h * * Copyright 2001 Sun Microsystems Inc. * * Erwann Chenede * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library 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 * Library General Public License for more details. * * You should have received a copy of the GNU Library 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. */ #if !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION) #error "Only can be included directly." #endif #ifndef __GDK_DISPLAY_H__ #define __GDK_DISPLAY_H__ #include #include #include G_BEGIN_DECLS #define GDK_TYPE_DISPLAY (gdk_display_get_type ()) #define GDK_DISPLAY(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), GDK_TYPE_DISPLAY, GdkDisplay)) #define GDK_IS_DISPLAY(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), GDK_TYPE_DISPLAY)) #ifndef GDK_DISABLE_DEPRECATED #define GDK_DISPLAY_OBJECT(object) GDK_DISPLAY(object) #endif typedef struct _GdkDisplayPointerHooks GdkDisplayPointerHooks; typedef struct _GdkDisplayDeviceHooks GdkDisplayDeviceHooks; /** * GdkDisplayPointerHooks: * @get_pointer: Obtains the current pointer position and modifier state. * The position is given in coordinates relative to the screen containing * the pointer, which is returned in @screen. * @window_get_pointer: Obtains the window underneath the mouse pointer. * Current pointer position and modifier state are returned in @x, @y and * @mask. The position is given in coordinates relative to @window. * @window_at_pointer: Obtains the window underneath the mouse pointer, * returning the location of that window in @win_x, @win_y. Returns %NULL * if the window under the mouse pointer is not known to GDK (for example, * belongs to another application). * * A table of pointers to functions for getting quantities related to * the current pointer position. Each #GdkDisplay has a table of this type, * which can be set using gdk_display_set_pointer_hooks(). * * This is only useful for such low-level tools as an event recorder. * Applications should never have any reason to use this facility * * Since: 2.2 */ struct _GdkDisplayPointerHooks { void (*get_pointer) (GdkDisplay *display, GdkScreen **screen, gint *x, gint *y, GdkModifierType *mask); GdkWindow* (*window_get_pointer) (GdkDisplay *display, GdkWindow *window, gint *x, gint *y, GdkModifierType *mask); GdkWindow* (*window_at_pointer) (GdkDisplay *display, gint *win_x, gint *win_y); }; /** * GdkDisplayDeviceHooks: * @get_device_state: Obtains the current position and modifier state for * @device. The position is given in coordinates relative to the window * containing the pointer, which is returned in @window. * @window_get_device_position: Obtains the window underneath the device * position. Current device position and modifier state are returned in * @x, @y and @mask. The position is given in coordinates relative to * @window. * @window_at_device_position: Obtains the window underneath the device * position, returning the location of that window in @win_x, @win_y. * Returns %NULL if the window under the mouse pointer is not known to * GDK (for example, belongs to another application). * * A table of pointers to functions for getting quantities related to * the current device position. Each #GdkDisplay has a table of this type, * which can be set using gdk_display_set_device_hooks(). */ struct _GdkDisplayDeviceHooks { void (* get_device_state) (GdkDisplay *display, GdkDevice *device, GdkScreen **screen, gint *x, gint *y, GdkModifierType *mask); GdkWindow * (* window_get_device_position) (GdkDisplay *display, GdkDevice *device, GdkWindow *window, gint *x, gint *y, GdkModifierType *mask); GdkWindow * (* window_at_device_position) (GdkDisplay *display, GdkDevice *device, gint *win_x, gint *win_y); }; GType gdk_display_get_type (void) G_GNUC_CONST; GdkDisplay *gdk_display_open (const gchar *display_name); G_CONST_RETURN gchar * gdk_display_get_name (GdkDisplay *display); gint gdk_display_get_n_screens (GdkDisplay *display); GdkScreen * gdk_display_get_screen (GdkDisplay *display, gint screen_num); GdkScreen * gdk_display_get_default_screen (GdkDisplay *display); #ifndef GDK_MULTIDEVICE_SAFE void gdk_display_pointer_ungrab (GdkDisplay *display, guint32 time_); void gdk_display_keyboard_ungrab (GdkDisplay *display, guint32 time_); gboolean gdk_display_pointer_is_grabbed (GdkDisplay *display); #endif /* GDK_MULTIDEVICE_SAFE */ gboolean gdk_display_device_is_grabbed (GdkDisplay *display, GdkDevice *device); void gdk_display_beep (GdkDisplay *display); void gdk_display_sync (GdkDisplay *display); void gdk_display_flush (GdkDisplay *display); void gdk_display_close (GdkDisplay *display); gboolean gdk_display_is_closed (GdkDisplay *display); #ifndef GDK_DISABLE_DEPRECATED GList * gdk_display_list_devices (GdkDisplay *display); #endif /* GDK_DISABLE_DEPRECATED */ GdkEvent* gdk_display_get_event (GdkDisplay *display); GdkEvent* gdk_display_peek_event (GdkDisplay *display); void gdk_display_put_event (GdkDisplay *display, const GdkEvent *event); gboolean gdk_display_has_pending (GdkDisplay *display); void gdk_display_add_client_message_filter (GdkDisplay *display, GdkAtom message_type, GdkFilterFunc func, gpointer data); void gdk_display_set_double_click_time (GdkDisplay *display, guint msec); void gdk_display_set_double_click_distance (GdkDisplay *display, guint distance); GdkDisplay *gdk_display_get_default (void); #ifndef GDK_MULTIDEVICE_SAFE void gdk_display_get_pointer (GdkDisplay *display, GdkScreen **screen, gint *x, gint *y, GdkModifierType *mask); GdkWindow * gdk_display_get_window_at_pointer (GdkDisplay *display, gint *win_x, gint *win_y); void gdk_display_warp_pointer (GdkDisplay *display, GdkScreen *screen, gint x, gint y); #endif /* GDK_MULTIDEVICE_SAFE */ void gdk_display_get_device_state (GdkDisplay *display, GdkDevice *device, GdkScreen **screen, gint *x, gint *y, GdkModifierType *mask); GdkWindow * gdk_display_get_window_at_device_position (GdkDisplay *display, GdkDevice *device, gint *win_x, gint *win_y); #ifndef GDK_MULTIDEVICE_SAFE GdkDisplayPointerHooks *gdk_display_set_pointer_hooks (GdkDisplay *display, const GdkDisplayPointerHooks *new_hooks); #endif /* GDK_MULTIDEVICE_SAFE */ GdkDisplayDeviceHooks *gdk_display_set_device_hooks (GdkDisplay *display, const GdkDisplayDeviceHooks *new_hooks); GdkDisplay *gdk_display_open_default_libgtk_only (void); gboolean gdk_display_supports_cursor_alpha (GdkDisplay *display); gboolean gdk_display_supports_cursor_color (GdkDisplay *display); guint gdk_display_get_default_cursor_size (GdkDisplay *display); void gdk_display_get_maximal_cursor_size (GdkDisplay *display, guint *width, guint *height); GdkWindow *gdk_display_get_default_group (GdkDisplay *display); gboolean gdk_display_supports_selection_notification (GdkDisplay *display); gboolean gdk_display_request_selection_notification (GdkDisplay *display, GdkAtom selection); gboolean gdk_display_supports_clipboard_persistence (GdkDisplay *display); void gdk_display_store_clipboard (GdkDisplay *display, GdkWindow *clipboard_window, guint32 time_, const GdkAtom *targets, gint n_targets); gboolean gdk_display_supports_shapes (GdkDisplay *display); gboolean gdk_display_supports_input_shapes (GdkDisplay *display); gboolean gdk_display_supports_composite (GdkDisplay *display); void gdk_display_notify_startup_complete (GdkDisplay *display, const gchar *startup_id); GdkDeviceManager * gdk_display_get_device_manager (GdkDisplay *display); GdkAppLaunchContext *gdk_display_get_app_launch_context (GdkDisplay *display); G_END_DECLS #endif /* __GDK_DISPLAY_H__ */