mirror of
https://gitlab.gnome.org/GNOME/gtk.git
synced 2024-11-17 14:30:15 +00:00
f1c32f109d
There is no need for apps to access this class, as its only implemented in the gdk backends, and we want to be free to change it later.
316 lines
13 KiB
C
316 lines
13 KiB
C
/*
|
|
* gdkdisplay.h
|
|
*
|
|
* Copyright 2001 Sun Microsystems Inc.
|
|
*
|
|
* Erwann Chenede <erwann.chenede@sun.com>
|
|
*
|
|
* 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 <gdk/gdk.h> can be included directly."
|
|
#endif
|
|
|
|
#ifndef __GDK_DISPLAY_H__
|
|
#define __GDK_DISPLAY_H__
|
|
|
|
#include <gdk/gdktypes.h>
|
|
#include <gdk/gdkevents.h>
|
|
#include <gdk/gdkdevicemanager.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
typedef struct _GdkDisplayClass GdkDisplayClass;
|
|
typedef struct _GdkDisplayPointerHooks GdkDisplayPointerHooks;
|
|
typedef struct _GdkDisplayDeviceHooks GdkDisplayDeviceHooks;
|
|
|
|
#define GDK_TYPE_DISPLAY (gdk_display_get_type ())
|
|
#define GDK_DISPLAY_OBJECT(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), GDK_TYPE_DISPLAY, GdkDisplay))
|
|
#define GDK_DISPLAY_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GDK_TYPE_DISPLAY, GdkDisplayClass))
|
|
#define GDK_IS_DISPLAY(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), GDK_TYPE_DISPLAY))
|
|
#define GDK_IS_DISPLAY_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GDK_TYPE_DISPLAY))
|
|
#define GDK_DISPLAY_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GDK_TYPE_DISPLAY, GdkDisplayClass))
|
|
|
|
/* Tracks information about the keyboard grab on this display */
|
|
typedef struct
|
|
{
|
|
GdkWindow *window;
|
|
GdkWindow *native_window;
|
|
gulong serial;
|
|
gboolean owner_events;
|
|
guint32 time;
|
|
} GdkKeyboardGrabInfo;
|
|
|
|
/* Tracks information about which window and position the pointer last was in.
|
|
* This is useful when we need to synthesize events later.
|
|
* Note that we track toplevel_under_pointer using enter/leave events,
|
|
* so in the case of a grab, either with owner_events==FALSE or with the
|
|
* pointer in no clients window the x/y coordinates may actually be outside
|
|
* the window.
|
|
*/
|
|
typedef struct
|
|
{
|
|
GdkWindow *toplevel_under_pointer; /* The toplevel window with mouse inside, tracked via native events */
|
|
GdkWindow *window_under_pointer; /* The window that last got sent a normal enter event */
|
|
gdouble toplevel_x, toplevel_y;
|
|
guint32 state;
|
|
guint32 button;
|
|
} GdkPointerWindowInfo;
|
|
|
|
typedef struct
|
|
{
|
|
guint32 button_click_time[2]; /* The last 2 button click times. */
|
|
GdkWindow *button_window[2]; /* The last 2 windows to receive button presses. */
|
|
gint button_number[2]; /* The last 2 buttons to be pressed. */
|
|
gint button_x[2]; /* The last 2 button click positions. */
|
|
gint button_y[2];
|
|
} GdkMultipleClickInfo;
|
|
|
|
struct _GdkDisplay
|
|
{
|
|
GObject parent_instance;
|
|
|
|
/*< private >*/
|
|
GList *GSEAL (queued_events);
|
|
GList *GSEAL (queued_tail);
|
|
|
|
/* Information for determining if the latest button click
|
|
* is part of a double-click or triple-click
|
|
*/
|
|
GHashTable *GSEAL (multiple_click_info);
|
|
|
|
guint GSEAL (double_click_time); /* Maximum time between clicks in msecs */
|
|
GdkDevice *GSEAL (core_pointer); /* Core pointer device */
|
|
|
|
const GdkDisplayDeviceHooks *GSEAL (device_hooks); /* Current hooks for querying pointer */
|
|
|
|
guint GSEAL (closed) : 1; /* Whether this display has been closed */
|
|
guint GSEAL (ignore_core_events) : 1; /* Don't send core motion and button event */
|
|
|
|
guint GSEAL (double_click_distance); /* Maximum distance between clicks in pixels */
|
|
|
|
GHashTable *GSEAL (device_grabs);
|
|
GHashTable *GSEAL (motion_hint_info);
|
|
|
|
/* Hashtable containing a GdkPointerWindowInfo for each device */
|
|
GHashTable *GSEAL (pointers_info);
|
|
|
|
/* Last reported event time from server */
|
|
guint32 GSEAL (last_event_time);
|
|
|
|
/* Device manager associated to the display */
|
|
GdkDeviceManager *GSEAL (device_manager);
|
|
};
|
|
|
|
/**
|
|
* 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);
|
|
|
|
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);
|
|
void gdk_display_warp_device (GdkDisplay *display,
|
|
GdkDevice *device,
|
|
GdkScreen *screen,
|
|
gint x,
|
|
gint 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);
|
|
|
|
GdkDeviceManager * gdk_display_get_device_manager (GdkDisplay *display);
|
|
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GDK_DISPLAY_H__ */
|