2008-07-01 22:57:50 +00:00
|
|
|
/* GDK - The GIMP Drawing Kit
|
2005-07-12 05:09:13 +00:00
|
|
|
* 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
|
2008-05-28 14:01:57 +00:00
|
|
|
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
|
2005-07-12 05:09:13 +00:00
|
|
|
*/
|
|
|
|
|
2008-05-28 14:01:57 +00:00
|
|
|
#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
|
|
|
|
#error "Only <gdk/gdk.h> can be included directly."
|
|
|
|
#endif
|
|
|
|
|
1997-11-24 22:37:52 +00:00
|
|
|
#ifndef __GDK_INPUT_H__
|
|
|
|
#define __GDK_INPUT_H__
|
|
|
|
|
1999-10-01 23:18:30 +00:00
|
|
|
#include <gdk/gdktypes.h>
|
1997-11-24 22:37:52 +00:00
|
|
|
|
2005-06-12 05:32:25 +00:00
|
|
|
G_BEGIN_DECLS
|
1997-11-24 22:37:52 +00:00
|
|
|
|
2001-06-30 02:56:50 +00:00
|
|
|
#define GDK_TYPE_DEVICE (gdk_device_get_type ())
|
|
|
|
#define GDK_DEVICE(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), GDK_TYPE_DEVICE, GdkDevice))
|
|
|
|
#define GDK_DEVICE_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GDK_TYPE_DEVICE, GdkDeviceClass))
|
|
|
|
#define GDK_IS_DEVICE(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), GDK_TYPE_DEVICE))
|
|
|
|
#define GDK_IS_DEVICE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GDK_TYPE_DEVICE))
|
|
|
|
#define GDK_DEVICE_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GDK_TYPE_DEVICE, GdkDeviceClass))
|
2001-06-28 16:35:38 +00:00
|
|
|
|
1999-10-01 23:18:30 +00:00
|
|
|
typedef struct _GdkDeviceKey GdkDeviceKey;
|
2000-07-03 19:00:23 +00:00
|
|
|
typedef struct _GdkDeviceAxis GdkDeviceAxis;
|
|
|
|
typedef struct _GdkDevice GdkDevice;
|
2001-06-30 02:56:50 +00:00
|
|
|
typedef struct _GdkDeviceClass GdkDeviceClass;
|
1999-10-01 23:18:30 +00:00
|
|
|
typedef struct _GdkTimeCoord GdkTimeCoord;
|
1997-11-24 22:37:52 +00:00
|
|
|
|
1999-10-01 23:18:30 +00:00
|
|
|
typedef enum
|
|
|
|
{
|
|
|
|
GDK_EXTENSION_EVENTS_NONE,
|
|
|
|
GDK_EXTENSION_EVENTS_ALL,
|
|
|
|
GDK_EXTENSION_EVENTS_CURSOR
|
|
|
|
} GdkExtensionMode;
|
1997-11-24 22:37:52 +00:00
|
|
|
|
1999-10-01 23:18:30 +00:00
|
|
|
typedef enum
|
1997-11-24 22:37:52 +00:00
|
|
|
{
|
1999-10-01 23:18:30 +00:00
|
|
|
GDK_SOURCE_MOUSE,
|
|
|
|
GDK_SOURCE_PEN,
|
|
|
|
GDK_SOURCE_ERASER,
|
|
|
|
GDK_SOURCE_CURSOR
|
|
|
|
} GdkInputSource;
|
1997-11-24 22:37:52 +00:00
|
|
|
|
1999-10-01 23:18:30 +00:00
|
|
|
typedef enum
|
|
|
|
{
|
|
|
|
GDK_MODE_DISABLED,
|
|
|
|
GDK_MODE_SCREEN,
|
|
|
|
GDK_MODE_WINDOW
|
|
|
|
} GdkInputMode;
|
1997-11-24 22:37:52 +00:00
|
|
|
|
1999-10-01 23:18:30 +00:00
|
|
|
typedef enum
|
|
|
|
{
|
|
|
|
GDK_AXIS_IGNORE,
|
|
|
|
GDK_AXIS_X,
|
|
|
|
GDK_AXIS_Y,
|
|
|
|
GDK_AXIS_PRESSURE,
|
|
|
|
GDK_AXIS_XTILT,
|
|
|
|
GDK_AXIS_YTILT,
|
2000-07-03 19:00:23 +00:00
|
|
|
GDK_AXIS_WHEEL,
|
1999-10-01 23:18:30 +00:00
|
|
|
GDK_AXIS_LAST
|
|
|
|
} GdkAxisUse;
|
|
|
|
|
2000-07-03 19:00:23 +00:00
|
|
|
struct _GdkDeviceKey
|
|
|
|
{
|
|
|
|
guint keyval;
|
|
|
|
GdkModifierType modifiers;
|
|
|
|
};
|
|
|
|
|
|
|
|
struct _GdkDeviceAxis
|
|
|
|
{
|
|
|
|
GdkAxisUse use;
|
|
|
|
gdouble min;
|
|
|
|
gdouble max;
|
|
|
|
};
|
|
|
|
|
|
|
|
struct _GdkDevice
|
1999-10-01 23:18:30 +00:00
|
|
|
{
|
2001-06-30 02:56:50 +00:00
|
|
|
GObject parent_instance;
|
2000-07-03 19:00:23 +00:00
|
|
|
/* All fields are read-only */
|
|
|
|
|
2010-05-27 14:11:25 +00:00
|
|
|
gchar *GSEAL (name);
|
|
|
|
GdkInputSource GSEAL (source);
|
|
|
|
GdkInputMode GSEAL (mode);
|
|
|
|
gboolean GSEAL (has_cursor); /* TRUE if the X pointer follows device motion */
|
2000-07-03 19:00:23 +00:00
|
|
|
|
2010-05-27 14:11:25 +00:00
|
|
|
gint GSEAL (num_axes);
|
|
|
|
GdkDeviceAxis *GSEAL (axes);
|
2000-07-03 19:00:23 +00:00
|
|
|
|
2010-05-27 14:11:25 +00:00
|
|
|
gint GSEAL (num_keys);
|
|
|
|
GdkDeviceKey *GSEAL (keys);
|
1997-11-24 22:37:52 +00:00
|
|
|
};
|
|
|
|
|
2000-07-03 19:00:23 +00:00
|
|
|
/* We don't allocate each coordinate this big, but we use it to
|
|
|
|
* be ANSI compliant and avoid accessing past the defined limits.
|
|
|
|
*/
|
|
|
|
#define GDK_MAX_TIMECOORD_AXES 128
|
1997-11-24 22:37:52 +00:00
|
|
|
|
1999-10-01 23:18:30 +00:00
|
|
|
struct _GdkTimeCoord
|
1997-11-24 22:37:52 +00:00
|
|
|
{
|
1999-10-01 23:18:30 +00:00
|
|
|
guint32 time;
|
2000-07-03 19:00:23 +00:00
|
|
|
gdouble axes[GDK_MAX_TIMECOORD_AXES];
|
1997-11-24 22:37:52 +00:00
|
|
|
};
|
|
|
|
|
2004-11-28 06:45:52 +00:00
|
|
|
GType gdk_device_get_type (void) G_GNUC_CONST;
|
2001-06-28 16:35:38 +00:00
|
|
|
|
2002-04-25 22:29:14 +00:00
|
|
|
#ifndef GDK_MULTIHEAD_SAFE
|
2000-07-03 19:00:23 +00:00
|
|
|
/* Returns a list of GdkDevice * */
|
2002-04-25 22:29:14 +00:00
|
|
|
GList * gdk_devices_list (void);
|
|
|
|
#endif /* GDK_MULTIHEAD_SAFE */
|
2000-07-03 19:00:23 +00:00
|
|
|
|
2010-05-27 14:11:25 +00:00
|
|
|
G_CONST_RETURN gchar *gdk_device_get_name (GdkDevice *device);
|
|
|
|
GdkInputSource gdk_device_get_source (GdkDevice *device);
|
|
|
|
GdkInputMode gdk_device_get_mode (GdkDevice *device);
|
|
|
|
gboolean gdk_device_get_has_cursor (GdkDevice *device);
|
|
|
|
|
|
|
|
void gdk_device_get_key (GdkDevice *device,
|
|
|
|
guint index,
|
|
|
|
guint *keyval,
|
|
|
|
GdkModifierType *modifiers);
|
|
|
|
GdkAxisUse gdk_device_get_axis_use (GdkDevice *device,
|
|
|
|
guint index);
|
|
|
|
|
2000-07-03 19:00:23 +00:00
|
|
|
/* Functions to configure a device */
|
|
|
|
void gdk_device_set_source (GdkDevice *device,
|
|
|
|
GdkInputSource source);
|
|
|
|
|
|
|
|
gboolean gdk_device_set_mode (GdkDevice *device,
|
|
|
|
GdkInputMode mode);
|
|
|
|
|
|
|
|
void gdk_device_set_key (GdkDevice *device,
|
2002-11-08 19:41:50 +00:00
|
|
|
guint index_,
|
2000-07-03 19:00:23 +00:00
|
|
|
guint keyval,
|
|
|
|
GdkModifierType modifiers);
|
|
|
|
|
|
|
|
void gdk_device_set_axis_use (GdkDevice *device,
|
2002-11-08 19:41:50 +00:00
|
|
|
guint index_,
|
2000-07-03 19:00:23 +00:00
|
|
|
GdkAxisUse use);
|
2009-08-18 18:35:10 +00:00
|
|
|
|
2000-07-03 19:00:23 +00:00
|
|
|
void gdk_device_get_state (GdkDevice *device,
|
|
|
|
GdkWindow *window,
|
|
|
|
gdouble *axes,
|
|
|
|
GdkModifierType *mask);
|
2009-08-18 18:35:10 +00:00
|
|
|
|
2000-07-03 19:00:23 +00:00
|
|
|
gboolean gdk_device_get_history (GdkDevice *device,
|
|
|
|
GdkWindow *window,
|
|
|
|
guint32 start,
|
|
|
|
guint32 stop,
|
|
|
|
GdkTimeCoord ***events,
|
|
|
|
gint *n_events);
|
2009-08-18 18:35:10 +00:00
|
|
|
|
2000-07-03 19:00:23 +00:00
|
|
|
void gdk_device_free_history (GdkTimeCoord **events,
|
|
|
|
gint n_events);
|
|
|
|
gboolean gdk_device_get_axis (GdkDevice *device,
|
|
|
|
gdouble *axes,
|
|
|
|
GdkAxisUse use,
|
|
|
|
gdouble *value);
|
|
|
|
|
|
|
|
void gdk_input_set_extension_events (GdkWindow *window,
|
|
|
|
gint mask,
|
|
|
|
GdkExtensionMode mode);
|
1999-10-01 23:18:30 +00:00
|
|
|
|
2002-06-18 23:23:30 +00:00
|
|
|
#ifndef GDK_MULTIHEAD_SAFE
|
Make gdkx.h the only installed header from gdk/x11. All structures in
Fri Sep 7 11:51:44 2001 Owen Taylor <otaylor@redhat.com>
Make gdkx.h the only installed header from gdk/x11.
All structures in gdk/x11 are opaque.
* gdk/x11/Makefile.am gdk/x11/gdkx.h gdk/x11/gdkprivate-x11.h:
Don't install gdk{drawable,pixmap,window}-x11.h.
* gdk/x11/{gdkcolormap-x11.c, gdkfont-x11.c, gdkx.h, gdkvisual-x11.c:
Move GdkColormapPrivateX11, GdkFontPrivateX GdkImagePrivateX11,
GdkVisualClass into C files.
* gdk/gdkpixmap-x11.[ch]: Make gdk_pixmap_impl_get_type() static.
* gdk/x11/{gdkcolor-x11.c, gdkcursor-x11.c, gdkdrawable-x11.c,
gdkfont-x11.c, gdkgc-x11.c, gdkx.h, gdkimage-x11,gdkvisual-x11.c}
Add public functions to replace previously exported direct
structure access.
gdk_x11_colormap_get_{xdisplay,xcolormap}
gdk_x11_cursor_get_{xdisplay,xcursor},
gdk_x11_drawable_get_{xdisplay,xcursor,gdk_x11_visual_get_xvisual,
gdk_x11_font_get_{xdisplay,xfont}, gdk_x11_image_get_{xdisplay,ximage},
gdk_x11_gc_get_{xdisplay,ximage}
* gdk/gdkprivate.h gdk/gdkinternals.h: Move GdkColorInfo,
GdkEventFilter, GdkClientFilter, GdkFontPrivate to gdkinternals.
Fix a number of variables and functions that were exported
"accidentally" from GDK.
* gdk/**.[ch]: gdk => _gdk for gdk_visual_init,
gdk_events_init, gdk_input_init, gdk_dnd_init, gdk_image_exit,
gdk_input_exit, gdk_windowing_exit, gdk_event_func, gdk_event_data,
gdk_event_notify, gdk_queued_events, gdk_queued_tail,
gdk_event_new, gdk_events_queue, gdk_events_unqueue,
gdk_event_queue_find_first, gdk_event_queue_remove_link,
gdk_event_queue_append, gdk_event_button_generate,
gdk_debug_flags, gdk_default_filters, gdk_parent_root.
* gdk/x11/{gdkevents-x11.c, gdkglobals-x11.c, gdkimage-x11.c,
gdkmain-x11.c, gdkprivate-x11.h, gdk/x11/gdkwindow-x11.c}:
gdk => _gdk for gdk_event_mask_table, gkd_nevent_masks,
gdk_wm_window_protocols, gdk_leader_window, gdk_xgrab_window,
gdk_use_xshm, gdk_input_ignore_core.
* gdk/x11/xsettings-common.h (xsettings_list_insert): Add
#defines to namespace functions into the private _gdk_
namespace.
* gdk/gdkwindow.[ch] gdk/x11/gdkx.h: Add gdk_get_default_root_window ()
to replace gdk_parent_root exported variable. Adjust and
deprecate GDK_ROOT_PARENT().
* demos/{testpixbuf-drawable.c,testpixbuf-save.c}: Fix
GDK_ROOT_PARENT usage, remove includes of port-specific
headers.
* gdk/{win32,x11,fb}/gdkinput*.[ch]: s/gdk/_gdk/ for
_gdk_input_gxid_host, _gdk_input_gxid_port, _gdk_input_ignore_core,
gdk_input_devices, _gdk_input_windows, gdk_init_input_core.
* gdk/x11/{gdkevents-x11.,c gdkglobals-x11.c, gdkmain-x11.c}
docs/Changes-2.0.txt: Remove gdk_wm_protocols,
gdk_wm_delete_window functions, gdk_wm_take_focus,
use gdk_atom_intern() instead.
* gdk/linux-fb/{gdkselection-fb.c, gdkmain-fb.c, gdkprivatefb.h}
gdk/win32/{gdkselection-win32.c, gdkmgdkwin32.h, gdkprivate-win32.h}
gdk/x11/{gdkselection-x11.c gdkx.h, gtkprivate-x11.h}
gtk/gtkselection.c
Unexport gdk_selection_property, just use
gdk_atom_intern ("GDK_SELECTION").
* gdk/x11/{gdkprivate-x11.h,gdkdrawable-x11h,gdkgc-x11.c,gdkx.h}:
Unexport gdk_drawable_impl_x11_get_type, gdk_gc_x11_get_type,
GDK_GC_X11 cast macros, GdkGCX11 structures, GdkCursorPrivate,
GdkVisualprivate, gdk_x11_gc_flush.
Make a number of public exports of variables into functions
to increase encapsulation.
* gdk/gdkinternals.h gdk/gdkinput.h gdk/gdkevents.h
gdk/linux-fb/gdkmouse-fb.c: gdk_core_pointer => _gdk_core_pointer,
move to gdkinternals.h. Add gdk_device_get_core_pointer ().
* gdk/gdkprivate.h gdk/gdkpango.c gdk/gdkinternals.h
docs/Changes-2.0.txt: Unexport gdk_parent_root, gdk_error_code,
gdk_error_warnings.
* gdk/x11/{gdkcolormap-x11.c, gdkmain-x11.c, gdkx.h}
docs/Changes-2.0.txt:
s/gdk_screen/_gdk_screen/, add gdk_x11_get_default_screen()
s/gdk_root_window/_gdk_root_window/, add gdk_x11_get_default_root_xwindow()
Add gdk_x11_get_default_xdisplay().
* gdk/gdk.h gdk/gdk.c linux-fb/gdkfb.h linux-fb/gdkglobals-fb.c
win32/gdkwin32.h x11/gdkglobals-x11.c gdk/x11/gdkmain-x11.c
gdk/x11/gdkx.h: gdk/gdk.def: Add gdk_get/set_program_class,
Don't export gdk_progclass, move --class command line
option and handling to common portion of GDK.
Miscellaneous fixes:
* gdk/x11/gdkwindow-x11.c (gdk_window_set_icon_list): Fix
g_return_val_if_fail that should have been g_return_if_fail.
* gdk/gdkinternals.h gdk/gdkprivate.h: Move
gdk_synthesize_window_state() to the semi-public gdkprivate.h.
* gtk/gtkdnd.c (_gtk_drag_source_handle_event): Remove uneeded
X11 dependency.
* gdk/linux-fb/gdkmain-fb.c gdk/win32/gdkmain-win32.c gdk/TODO:
Remove unused gdk_key_repeat_disable/restore.
* linux-fb/gdkglobals-fb.c win32/gdkglobals-win32.c
x11/gdkglobals-x11.c x11/gdkprivate-x11.h gdk/gdk.def:
Remove unused gdk_null_window_warnings variable.
* gdk/Makefile.am (DIST_SUBDIRS) nanox/*: cvs remove nanox;
it can be retrieved from the repository; it is too far
from functional to be worth having people check out;
it would be easier to start from scratch, I suspect.
* gdk/x11/gdkpixmap-x11.c: Fix lvalue usage of GDK_PIXMAP_XID().
* gdk/x11/gdkkeys-x11.c gdk/gdkrgb.c gdk/gdkwindow.c
gdk/x11/gdkpango-x11.c gdk/x11/gdkselection-x11.c:
Fix some accidentally global variables and unused global variables.
* gdk/x11/gdkkeys-x11.c gdk/gdkrgb.c gdk/gdkwindow.c
gdk/x11/gdkpango-x11.c gdk/x11/gdkselection-x11.c:
Fix some accidentally global variables and unused global variables.
Add some space for future expansion to multihead.
* gdk/gdkdrawable.h: Add four reserved function pointers
for future expansion of GdkDrawableClass.
* gtk/gtkwindow.h gtk/gtkinvisible.h: Add reserved pointer
where we can put a GdkScreen * later.
2001-09-07 21:50:20 +00:00
|
|
|
GdkDevice *gdk_device_get_core_pointer (void);
|
2002-06-18 23:23:30 +00:00
|
|
|
#endif
|
2000-07-03 19:00:23 +00:00
|
|
|
|
2005-06-12 05:32:25 +00:00
|
|
|
G_END_DECLS
|
1997-11-24 22:37:52 +00:00
|
|
|
|
1997-12-02 19:41:19 +00:00
|
|
|
#endif /* __GDK_INPUT_H__ */
|